IPnpCallbackHardware::OnReleaseHardware 메서드(wudfddi.h)

아티클
02/14/2022
읽는 데 2분 걸림

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. For more info, see Getting Started with UMDF.]

OnReleaseHardware 메서드는 지정된 하드웨어에 더 이상 액세스할 수 없는 경우 필요한 작업을 수행하도록 드라이버에 알릴 수 있습니다.

구문

HRESULT OnReleaseHardware(
  [in] IWDFDevice *pWdfDevice
);

매개 변수

[in] pWdfDevice

더 이상 액세스할 수 없는 디바이스의 디바이스 개체에 대한 IWDFDevice 인터페이스에 대한 포인터입니다.

반환 값

OnReleaseHardware 는 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다. HRESULT_FROM_NT(STATUS_NOT_SUPPORTED)를 반환하지 마세요.

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

설명

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

OnReleaseHardware 메서드는 OnPrepareHardware의 성공 또는 실패 여부에 관계없이 드라이버의 IPnpCallbackHardware::OnPrepareHardware 메서드를 호출하는 동안 할당된 리소스를 해제해야 합니다. 따라서 OnReleaseHardware 는 부분 리소스 정리를 처리할 수 있어야 합니다.

자세한 내용은 UMDF 드라이버에서 하드웨어 리소스 찾기 및 매핑을 참조하세요.