필터 입력 메시지

E_NOTIMPL이 반환되지 않는 한 메시지를 받을 때마다 PresentationHost.exe에서 호출됩니다.

문법

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

매개 변수

pMsg

[in] 원시 입력을 가져오는 창으로 전송되는 WM_INPUT 메시지입니다.

속성 값/반환 값

HRESULT:

S_OK - 필터가 메시지를 처리하지 않았으며 추가 처리가 발생할 수 있습니다.

S_FALSE - 필터가 이 메시지를 처리했으며 추가 처리가 발생하면 안 됩니다.

E_NOTIMPL - 이 값이 반환되는 경우, FilterInputMessage는 다시 호출되지 않습니다. 이 값은 사용자 지정 진행률 및 오류 사용자 인터페이스를 PresentationHost.exe에 제공하는 것에만 관심이 있고 PresentationHost.exe에서 원시 입력 메시지를 전달받지 않으려는 호스트 애플리케이션에서 반환될 수 있습니다.

비고

PresentationHost.exe는 키보드, 마우스 및 리모컨을 비롯한 다양한 원시 입력 디바이스의 대상입니다. 호스트 애플리케이션의 동작은 종종 PresentationHost.exe에서 사용할 수 있는 입력에 따라 달라집니다. 예를 들어 호스트 애플리케이션은 특정 입력 메시지를 수신하여 특정 사용자 인터페이스 요소를 표시할지 여부를 확인할 수 있습니다.

호스트 애플리케이션이 이러한 동작을 제공하기 위해 필요한 입력 메시지를 수신할 수 있도록 PresentationHost.exe는 FilterInputMessage를 호출하여 호스트된 애플리케이션에 적절한 원시 입력 메시지를 전달합니다.

호스트된 애플리케이션은 GetRawInputDevices에서 반환된 원시 입력 디바이스 집합 (휴먼 인터페이스 디바이스)에 등록하여 지속적으로 원시 입력 메시지를 수신합니다.

참고하십시오

• WM_INPUT 메시지