피드백

WdfDeviceIndicateWakeStatus 함수(wdfdevice.h)

  • 아티클
  • 읽는 데 3분 걸림

[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)