IWDFDeviceInitialize::SetFilter 메서드(wudfddi.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

SetFilter 메서드는 디바이스를 필터 디바이스로 사용하도록 설정하는 속성을 설정합니다.

구문

void SetFilter();

반환 값

없음

설명

필터 드라이버는 SetFilter 를 호출하여 자신을 필터로 표시합니다. 드라이버가 필터임을 프레임워크에 알릴 때 프레임워크는 다음과 같습니다.

• 필터가 스택의 다음 논리 드라이버에 콜백을 등록하지 않은 I/O 요청을 보냅니다. 예를 들어 필터 드라이버는 IQueueCallbackDeviceIoControl::OnDeviceIoControl 메서드를 제공하지만 IQueueCallbackRead::OnRead 또는 IQueueCallbackWrite::OnWrite는 제공하지 않습니다. 따라서 필터 드라이버는 디바이스 I/O 제어 요청만 받습니다.
• 드라이버가 IWDFDeviceInitialize::AutoForwardCreateCleanupClose 메서드를 호출할 필요가 없도록 파일 만들기, 정리 및 닫기 요청을 자동으로 전달합니다.

드라이버는 일반적으로 IDriverEntry::OnDeviceAdd 메서드에서 SetFilter를 호출합니다.

예제

SetFilter 메서드를 사용하는 방법에 대한 코드 예제는 IWDFDriver::CreateDevice를 참조하세요.

요구 사항

요구 사항	값
지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	데스크톱
최소 UMDF 버전	1.5
머리글	wudfddi.h(Wudfddi.h 포함)
DLL	WUDFx.dll

추가 정보

IWDFDeviceInitialize

IWDFDriver::CreateDevice