IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.
UMDF 기반 드라이버의 OnRemoteTargetQueryRemove 이벤트 콜백 함수는 원격 I/O 대상의 디바이스를 중지하고 제거할 수 있는지 여부를 결정합니다.
통사론
BOOL OnRemoteTargetQueryRemove(
[in] IWDFRemoteTarget *pWdfRemoteTarget
);
매개 변수
[in] pWdfRemoteTarget
원격 I/O 대상나타내는 원격 대상 개체의 IWDFRemoteTarget 인터페이스에 대한 포인터입니다. 드라이버는 IWDFDevice2::CreateRemoteTarget호출할 때 이 포인터를 가져옵니다.
반환 값
드라이버가 디바이스를 중지하고 제거할 수 있다고 판단하는 경우 OnRemoteTargetQueryRemove 이벤트 콜백 함수는 TRUE반환해야 합니다. 그렇지 않으면 콜백 함수는 false 반환해야 합니다.
발언
드라이버가 onRemoteTargetQueryRemove 이벤트 콜백 함수에 제공하는 경우 콜백 함수는 운영 체제에서 디바이스 제거를 허용해야 하는지 여부를 결정해야 합니다. 드라이버가 디바이스를 제거할 수 있다고 판단하는 경우 다음을 수행해야 합니다.
- 원격 대상에 대한 I/O를 중지하는 데 필요한 드라이버별 작업을 수행합니다.
- IWDFRemoteTarget::CloseForQueryRemove호출합니다.
- TRUE 반환하여 제거가 발생할 수 있음을 나타냅니다.
드라이버가 이 콜백 함수를 제공하지 않으면 프레임워크는 드라이버에 대해 IWDFRemoteTarget::CloseForQueryRemove 호출합니다. 즉, 드라이버가 onRemoteTargetQueryRemove 이벤트 콜백 함수를 제공하지 않는 한 프레임워크는 항상 디바이스를 제거할 수 있도록 허용합니다.
OnRemoteTargetQueryRemove 이벤트 콜백 함수에 대한 자세한 내용은 UMDF일반 I/O 대상의 상태 제어를 참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.9 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |