DXGK_GRAPHICSPOWER_REGISTER_INPUT_V_1_2 구조체(d3dkmthk.h)

DXGK_GRAPHICSPOWER_REGISTER_INPUT_V_1_2 구조체는 새 입력의 전원 상태를 등록하는 데 사용됩니다.

구문

typedef struct _DXGK_GRAPHICSPOWER_REGISTER_INPUT_V_1_2 {
  ULONG                         Version;
  PVOID                         PrivateHandle;
  PDXGK_POWER_NOTIFICATION      PowerNotificationCb;
  PDXGK_REMOVAL_NOTIFICATION    RemovalNotificationCb;
  PDXGK_FSTATE_NOTIFICATION     FStateNotificationCb;
  PDXGK_INITIAL_COMPONENT_STATE InitialComponentStateCb;
} DXGK_GRAPHICSPOWER_REGISTER_INPUT_V_1_2, *PDXGK_GRAPHICSPOWER_REGISTER_INPUT_V_1_2;

멤버

Version

사용 중인 현재 버전입니다. 이 값은 다음 DXGK_GRAPHICSPOWER_VERSIONs 중 하나로 설정해야 합니다.

#define DXGK_GRAPHICSPOWER_VERSION_1_0 0x1000
#define DXGK_GRAPHICSPOWER_VERSION_1_1 0x1001
#define DXGK_GRAPHICSPOWER_VERSION_1_2 0x1002
#define DXGK_GRAPHICSPOWER_VERSION DXGK_GRAPHICSPOWER_VERSION_1_2

기본적으로 DXGK_GRAPHICSPOWER_VERSION 최신 버전을 나타냅니다. 그래픽 하위 시스템은 현재 버전과 모든 이전 버전을 지원합니다. 이 값이 인식되지 않는 버전인 경우 STATUS_NOINTERFACE 실패합니다. 이는 그래픽이 아닌 드라이버가 현재 실행 중인 OS보다 최신 OS용으로 빌드된 경우에만 발생하며, 이 경우 그래픽이 아닌 드라이버가 더 낮은 버전 번호로 다시 시도해야 합니다.

DXGK_GRAPHICSPOWER_VERSION_1_1 F 상태 변경 알림을 지원합니다. DXGK_GRAPHICSPOWER_VERSION_1_2 공유 전원 구성 요소 데이터 및 상태의 초기 열거를 지원합니다.

PrivateHandle

콜백에 제공될 불투명 핸들입니다. 이 핸들은 전역적으로 고유해야 하므로 호출 드라이버의 PDO 또는 FDO에 대한 포인터를 사용해야 합니다. 이 핸들은 그래픽에서 이 특정 등록을 추적하는 키로 사용되며 향후 제거를 처리하기 위해 그래픽이 아닌 드라이버 콜백과 연결됩니다.

PowerNotificationCb

그래픽 디바이스가 디바이스 전원 상태 전환 중임을 알리는 콜백이며 새 DEVICE_POWER_STATE 제공합니다. 이 콜백을 구현해야 합니다. PDXGK_POWER_NOTIFICATION 참조하세요.

RemovalNotificationCb

그래픽 디바이스가 제거되고 있음을 알리는 콜백입니다. 이 DeviceHandle에 대한 그래픽에 대한 추가 콜백은 실패한 NTSTATUS 코드를 반환하며 RemoveNotificationCb 콜백에서 돌아올 때까지 차단됩니다. 이 콜백을 구현해야 합니다. PDXGK_REMOVAL_NOTIFICATION 참조하세요.

FStateNotificationCb

상태 알림을 발급합니다. 이 콜백은 선택 사항이며 그래픽이 아닌 드라이버에서 사용됩니다. PDXGK_FSTATE_NOTIFICATION 참조하세요.

InitialComponentStateCb

구성 요소 상태를 초기화합니다. PDXGK_INITIAL_COMPONENT_STATE 참조하세요.

설명

그래픽 드라이버는 DXGKQAITYPE_NUMPOWERCOMPONENTS 쿼리에 응답하여 존재하는 전원 구성 요소를 나타내고 _DXGK_QUERYADAPTERINFOTYPE DXGKQAITYPE_POWERCOMPONENTINFO.

그래픽 드라이버가 하나 이상의 DXGK_POWER_COMPONENT_SHARED 구성 요소를 등록하는 경우 해당 어댑터에 대해 GRAPHICSPOWER 인터페이스가 만들어집니다. 인터페이스는 이러한 구성 요소를 노출하지 않는 어댑터에 대해 등록되지 않습니다.

그래픽 드라이버는 DXGK_POWER_RUNTIME_COMPONENT 플래그 ActiveInD3 을 0으로 설정하거나 이 플래그를 1로 설정하여 "차단 해제" 구성 요소를 등록할 수 있습니다.

차단 전원 구성 요소는 비차단 전원 구성 요소가 사용하지 않을 때 그래픽 디바이스의 전원이 낮아지지 않도록 합니다. 둘 다 그래픽이 아닌 드라이버에서 사용 중일 때 그래픽 드라이버가 전원 평면을 제대로 관리할 수 있도록 합니다.

그래픽 드라이버가 비 그래픽 드라이버가 차단 또는 비차단 사용을 선택적으로 선택할 수 있는 기능을 제공하려는 경우 단일 물리적/논리적 구성 요소에 대한 차단 및 비차단 전원 구성 요소를 모두 노출할 수 있습니다.

GRAPHICSPOWER 드라이버 인터페이스를 사용할 수 있고 사용하도록 설정하면 그래픽이 아닌 드라이버는 그래픽 드라이버에 IO를 호출하여 공유 전원 구성 요소를 관리하는 데 사용할 콜백을 제공하고 가져오는 그래픽 드라이버에 등록할 수 있습니다. IO 호출은 입력 데이터 DXGK_GRAPHICSPOWER_REGISTER_INPUT_V_1_2 출력 데이터 _DXGK_GRAPHICSPOWER_REGISTER_OUTPUT 함께 IOCTL_INTERNAL_GRAPHICSPOWER_REGISTER 제어 코드를 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1803(WDDM 2.4)
머리글	d3dkmthk.h