다음을 통해 공유

D3COLD_REQUEST_AUX_POWER 콜백 함수(wdm.h)

  • 아티클

FDO(함수 디바이스 개체)가 보조 전원 요구 사항을 전달할 수 있도록 합니다.

구문

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

NTSTATUS D3coldRequestAuxPower(
  [_In_reads_opt_(_Inexpressible_("varies"))] PVOID Context,
  [_In_]                                      ULONG AuxPowerInMilliWatts,
  [_Out_]                                     PULONG RetryInSeconds
)
{...}

매개 변수

Context

디바이스에 대한 핸들입니다.

[_In_] AuxPowerInMilliWatts

시스템이 S0에 있을 때 디바이스가 D3cold에 필요한 mW 단위의 와트입니다. 이 값은 0x80000000 미만이어야 합니다.

[_Out_] RetryInSeconds

요청이 STATUS_RETRY 실패할 때 드라이버가 요청을 다시 시도할 수 있는 시간(초)을 수신하는 ULONG 변수에 대한 포인터입니다.

반환 값

작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 NTSTATUS 값 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값을 참조하세요. 가능한 오류는 다음과 같습니다.

오류 코드 Description
STATUS_INVALID_PARAMETER 입력 매개 변수가 잘못되었습니다.
STATUS_INVALID_DEVICE_REQUEST 디바이스가 D0에 없거나 요청자가 함수 0이 아닙니다.
STATUS_RETRY 요청이 실패했고 시스템은 재시도를 수행할 수 있음을 나타냅니다. RetryInSeconds에는 드라이버가 다음 요청을 하기 전에 기다려야 하는 시간(초)이 포함됩니다.
STATUS_UNSUCCESSFUL 요청이 실패하고 시스템에서 현재 요청된 값을 사용할 수 없음을 나타냅니다.
STATUS_SUCCESS 요청이 성공했습니다.

설명

GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE 인터페이스를 성공적으로 쿼리하는 디바이스 드라이버는 드라이버가 RequestAuxPower 멤버를 D3COLD_REQUEST_AUX_POWER 콜백 함수 구현에 대한 포인터로 설정하는 D3COLD_AUX_POWER_AND_TIMING_INTERFACE 구조에 대한 포인터를 받습니다.

  • 다기능 디바이스의 경우 함수 0만 이 루틴을 호출하고 전체 디바이스에 대한 보조 전원을 설정해야 합니다.

  • 함수 0은 이 루틴이 호출될 때 D0 상태여야 합니다.

  • 이 요청이 성공한 후 핵심 전력 레일 전력이 제거될 것이라는 보장은 없습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10, 버전 1803
머리글 wdm.h(Wdm.h 포함)