IPnpCallback::OnQueryRemove 메서드(wudfddi.h)

  • 아티클

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

OnQueryRemove 메서드는 컴퓨터에서 디바이스를 제거하기 전에 드라이버에 알릴 수 있습니다.

구문

HRESULT OnQueryRemove(
  [in] IWDFDevice *pWdfDevice
);

매개 변수

[in] pWdfDevice

제거될 디바이스의 디바이스 개체에 대한 IWDFDevice 인터페이스에 대한 포인터입니다.

반환 값

드라이버가 디바이스를 중지하고 제거할 수 있다고 판단하는 경우 OnQueryRemove 콜백 메서드는 S_OK 또는 SUCCEEDED(상태)가 TRUE인 다른 상태 코드를 반환해야 합니다. 그렇지 않으면 SUCCEEDED(상태)가 FALSE와 같은 상태 코드를 반환해야 합니다. HRESULT 오류 코드는 Winerror.h에 정의되어 있습니다. HRESULT_FROM_NT(STATUS_NOT_SUPPORTED)을 반환하지 마세요.

이 메서드는 HRESULT_FROM_NT 매크로를 사용하여 커널 모드 클라이언트에 상태 반환하는 특정 HRESULT 값을 반환해야 합니다. 자세한 내용은 커널 모드 클라이언트 지원을 참조하세요.

설명

드라이버는 IWDFDriver::CreateDevice 메서드를 호출하여 디바이스 개체를 만들 때 IPnpCallback 인터페이스를 등록합니다.

프레임워크는 OnQueryRemove 콜백 함수를 다른 PnP 및 전원 관리 콜백 함수와 동기화하지 않습니다.

OnQueryRemove 콜백 메서드에 대한 자세한 내용은 사용자가 디바이스 플러그를 뽑기를 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 wudfddi.h(Wudfddi.h 포함)

추가 정보

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice