다음을 통해 공유


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

[경고: 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(status)가 TRUE 다른 상태 코드를 반환해야 합니다.

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

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

발언

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

요구 사항

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

참고 항목

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice

WDF_POWER_DEVICE_STATE