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)