WdfDeviceIndicateWakeStatus 함수(wdfdevice.h)

  • 아티클

[KMDF에만 적용]

WdfDeviceIndicateWakeStatus 메서드는 호출 버스 드라이버가 지정된 디바이스가 버스에서 절전 모드 해제 신호를 트리거할 때까지 기다리지 않는다는 것을 프레임워크에 알릴 수 있습니다.

구문

NTSTATUS WdfDeviceIndicateWakeStatus(
  [in] WDFDEVICE Device,
  [in] NTSTATUS  WaitWakeStatus
);

매개 변수

[in] Device

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

[in] WaitWakeStatus

NTSTATUS 상태 값입니다. 디바이스가 절전 모드 해제 신호를 트리거한 경우 호출자는 이 값을 STATUS_SUCCESS 또는 NT_SUCCESS(WaitWakeStatus)가 TRUE인 다른 상태 값으로 설정해야 합니다. 디바이스가 절전 모드 해제 신호를 트리거하지 않았거나 오류가 감지된 경우 호출자는 NT_SUCCESS(WaitWakeStatus)가 FALSE인 상태 값을 제공해야 합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

작업이 성공하면 WdfDeviceIndicateWakeStatus 는 STATUS_SUCCESS 반환합니다. 추가 반환 값은 다음과 같습니다.

반환 코드 설명
STATUS_INVALID_PARAMETER
 WaitWakeStatus 가 STATUS_PENDING 또는 STATUS_CANCELLED.
STATUS_INVALID_DEVICE_REQUEST
 드라이버 스택이 디바이스가 절전 모드 해제 신호를 트리거할 때까지 기다리도록 설정되지 않았습니다.
STATUS_INVALID_DEVICE_STATE
 호출 드라이버는 디바이스가 절전 모드 해제 신호를 트리거할 때까지 대기할 책임이 없습니다.
 

메서드는 다른 NTSTATUS 값을 반환할 수 있습니다.

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

설명

NT_SUCCESS(WaitWakeStatus)가 TRUE인 경우 프레임워크는 디바이스와 시스템을 작동 상태로 복원합니다. NT_SUCCESS(WaitWakeStatus)가 FALSE인 경우 디바이스와 시스템은 현재 상태로 유지됩니다.

WdfDeviceIndicateWakeStatus 메서드를 호출하는 방법에 대한 자세한 내용은 지원 시스템 절전 모드 해제를 참조하세요.

예제

다음 코드 예제는 지정된 디바이스가 절 해제 신호를 트리거했음을 프레임워크에 알릴 수 있습니다.

NTSTATUS  status;

status = WdfDeviceIndicateWakeStatus(
                                     hChild,
                                     STATUS_SUCCESS
                                     );

요구 사항

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