D3COLD_AUX_POWER_AND_TIMING_INTERFACE 구조체(wdm.h)

아티클
08/08/2023

디바이스 드라이버가 D3Cold 상태인 동안 PCI 디바이스에 대해 더 높은 보조 성능을 협상할 수 있는 인터페이스 구조의 확장 버전입니다. 이 인터페이스를 사용하면 디바이스 드라이버가 _DSM 함수 0Ah, 0Bh를 조작하는 함수를 호출할 수 있습니다.

구문

typedef struct _D3COLD_AUX_POWER_AND_TIMING_INTERFACE {
  USHORT                          Size;
  USHORT                          Version;
  PVOID                           Context;
  PINTERFACE_REFERENCE            InterfaceReference;
  PINTERFACE_DEREFERENCE          InterfaceDereference;
  PD3COLD_REQUEST_CORE_POWER_RAIL RequestCorePowerRail;
  PD3COLD_REQUEST_AUX_POWER       RequestAuxPower;
  PD3COLD_REQUEST_PERST_DELAY     RequestPerstDelay;
} D3COLD_AUX_POWER_AND_TIMING_INTERFACE, *PD3COLD_AUX_POWER_AND_TIMING_INTERFACE;

멤버

Size

이 구조체의 크기(바이트)입니다.

Version

드라이버 정의 인터페이스 버전입니다. 이 인터페이스의 현재 버전은 D3COLD_AUX_POWER_AND_TIMING_INTERFACE_VERSION.

Context

인터페이스별 컨텍스트 정보에 대한 포인터입니다.

InterfaceReference

인터페이스의 참조 횟수를 증가시키는 InterfaceReference 루틴에 대한 포인터입니다.

InterfaceDereference

인터페이스의 참조 수를 감소시키는 InterfaceDereference 루틴에 대한 포인터입니다.

RequestCorePowerRail

FDO(함수 디바이스 개체)가 핵심 전원 레일이 필요한지 여부를 나타낼 수 있도록 하는 D3COLD_REQUEST_CORE_POWER_RAIL 콜백 함수에 대한 포인터입니다.

RequestAuxPower

FDO(함수 디바이스 개체)가 보조 전원 요구 사항을 전달할 수 있도록 하는 _D3COLD_REQUEST_AUX_POWER 콜백 함수에 대한 포인터입니다.

RequestPerstDelay

D3COLD_REQUEST_PERST_DELAY 대한 포인터를 사용하면 FDO(함수 디바이스 개체)가 고정 지연 시간에 대한 요구 사항을 전달할 수 있습니다.

설명

GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE 인터페이스를 성공적으로 쿼리하는 디바이스 드라이버는 인터페이스의 루틴에 대한 포인터가 모두 NULL이 아니고 유효한 [D3COLD_AUX_POWER_AND_TIMING_INTERFACE] 구조체에 대한 포인터를 받습니다.

[D3COLD_AUX_POWER_AND_TIMING_INTERFACE] 구조체는 [INTERFACE] 구조체의 확장 버전입니다.

이제 Windows는 런타임 디바이스 전원 관리를 위해 새로 도입된 PCI _DSM(디바이스별 방법) 기능에 대한 지원을 추가했습니다. 아래에 나열된 새 인터페이스를 사용하면 디바이스 드라이버가 D3Cold 상태인 동안 추가 전원이 필요한 경우 PCI 디바이스에 대해 더 높은 보조 전력(표준 375mA @ 3.3V보다 높음)을 협상할 수 있습니다. 모든 디바이스 드라이버는 시스템에서 추가 전원을 제공할 수 없거나 인터페이스가 지원되지 않는 경우를 처리할 수 있어야 합니다.

런타임 디바이스 전원 관리에 대한 _DSM 기능을 지원하는 모든 PCIe 포트는 PCIe 포트의 ACPI scope 따라 D3_COLD_AUX_POWER ECN 인터페이스를 지원하는 PCIe 포트를 식별하기 위한 _DSD(디바이스별 데이터)를 구현해야 합니다.