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 이벤트 콜백 함수를 제공하는 경우 콜백 함수는 운영 체제에서 디바이스 제거를 허용해야 하는지 여부를 결정해야 합니다. 드라이버가 디바이스를 제거할 수 있다고 판단하는 경우 다음을 수행해야 합니다.

1. 원격 대상에 대한 I/O를 중지하는 데 필요한 드라이버별 작업을 수행합니다.
2. IWDFRemoteTarget::CloseForQueryRemove를 호출합니다.
3. TRUE를 반환하여 제거가 발생할 수 있음을 나타냅니다.

드라이버가 디바이스를 제거하지 않아야 한다고 판단하는 경우 콜백 함수는 FALSE를 반환해야 합니다. 일반적으로 FALSE 반환 값으로 인해 Windows가 다시 시작될 수 있으므로 드라이버는 FALSE를 반환하지 않아야 합니다.

드라이버가 이 콜백 함수를 제공하지 않으면 프레임워크는 드라이버에 대해 IWDFRemoteTarget::CloseForQueryRemove 를 호출합니다. 즉, 드라이버가 OnRemoteTargetQueryRemove 이벤트 콜백 함수를 제공하지 않는 한 프레임워크는 항상 디바이스를 제거할 수 있도록 허용합니다.

OnRemoteTargetQueryRemove 이벤트 콜백 함수에 대한 자세한 내용은 UMDF에서 일반 I/O 대상의 상태 제어를 참조하세요.

요구 사항

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

추가 정보

IRemoteTargetCallbackRemoval

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete