WdfDeviceGetDevicePowerState 함수(wdfdevice.h)

[KMDF에만 적용]

참고

이 함수는 Microsoft 내부 용도로만 사용됩니다.

WdfDeviceGetDevicePowerState 메서드는 지정된 디바이스에 대해 프레임워크 전원 상태 컴퓨터의 현재 상태를 반환합니다.

구문

WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
  [in] WDFDEVICE Device
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

반환 값

WdfDeviceGetDevicePowerState 는 지정된 디바이스에 대한 프레임워크 전원 상태 컴퓨터의 현재 상태를 식별하는 WDF_DEVICE_POWER_STATE 형식의 열거자를 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

프레임워크의 상태 컴퓨터에 대한 자세한 내용은 프레임워크의 상태 머신을 참조하세요.

WdfDeviceGetDevicePowerState 메서드는 다음 콜백 함수 내에서 호출되는 경우에만 의미 있는 값을 반환합니다.

• EvtDevicePrepareHardware

• EvtDeviceReleaseHardware

• EvtDeviceD0Entry

• EvtDeviceD0EntryPostInterruptsEnabled

• EvtDeviceD0Exit

• EvtDeviceD0ExitPreInterruptsDisabled

• EvtDeviceSelfManagedIoInit

• EvtDeviceSelfManagedIoSuspend

• EvtDeviceSelfManagedIoRestart

예제

다음 코드 예제에서는 지정된 디바이스에 대한 프레임워크 전원 상태 컴퓨터의 현재 상태를 가져옵니다.

WDF_DEVICE_POWER_STATE state;

state = WdfDeviceGetDevicePowerState(Device);

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
머리글	wdfdevice.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerPolicyState