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

아티클
08/08/2023

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

OnD0Entry 메서드는 디바이스가 D0 전원 상태가 되면 드라이버가 디바이스 사용과 같은 필요한 작업을 수행할 수 있도록 드라이버에 알릴 수 있습니다.

구문

HRESULT OnD0Entry(
  [in] IWDFDevice             *pWdfDevice,
  [in] WDF_POWER_DEVICE_STATE previousState
);

매개 변수

[in] pWdfDevice

D0 전원 상태를 입력하는 디바이스의 디바이스 개체에 대한 IWDFDevice 인터페이스에 대한 포인터입니다.

[in] previousState

D0 전원 상태가 되기 전에 디바이스의 전원 상태를 식별하는 WDF_POWER_DEVICE_STATE 형식의 값입니다.

반환 값

OnD0Entry 콜백에 오류가 발생하지 않으면 S_OK 또는 SUCCEEDED(상태)가 TRUE인 다른 상태 코드를 반환해야 합니다.

SUCCEEDED(상태)가 FALSE와 같은 상태 코드를 반환하면 프레임워크는 디바이스를 제거합니다. 디바이스의 드라이버가 시스템에서 다른 디바이스를 지원하지 않는 경우 I/O 관리자가 드라이버를 언로드합니다. 프레임워크는 PnP 관리자에게 알린 다음, 버스 드라이버에 디바이스를 다시 열거하도록 요청하여 디바이스를 다시 시작하려고 합니다. 드라이버가 언로드된 경우 드라이버가 다시 로드됩니다. 이 경우 프레임워크는 드라이버의 IPnpCallback::OnD0Exit 콜백 함수를 호출하지 않습니다.

HRESULT 오류 코드는 Winerror.h에 정의되어 있습니다.