PDXGK_INITIAL_COMPONENT_STATE 콜백 함수(d3dkmthk.h)

2025-02-06

PDXGK_INITIAL_COMPONENT_STATE 콜백 함수는 구성 요소 상태를 초기화하기 위해 클라이언트 드라이버에 의해 구현됩니다.

통사론

PDXGK_INITIAL_COMPONENT_STATE PdxgkInitialComponentState;

void PdxgkInitialComponentState(
  PVOID GraphicsDeviceHandle,
  PVOID PrivateHandle,
  ULONG ComponentIndex,
  BOOLEAN IsBlockingType,
  UINT InitialFState,
  GUID ComponentGuid,
  UINT PowerComponentMappingFlag
)
{...}

매개 변수

GraphicsDeviceHandle

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

PrivateHandle

콜백에 제공되는 불투명 핸들입니다. 이 핸들은 전역적으로 고유해야 하므로 호출 드라이버의 PDO 또는 FDO에 대한 포인터를 사용해야 합니다.

ComponentIndex

구성 요소의 인덱스입니다. 일반적으로 그래픽 어댑터에서 사용하는 인덱스입니다. LDA(연결된 디스플레이 어댑터) 시나리오에서는 예외입니다. 여기서 ComponentIndex HIWORD는 그래픽 드라이버가 LDA 시나리오의 F 상태 변경에 대한 그래픽 커널에 의해 호출될 때와 같이 어댑터 인덱스를 나타냅니다.

IsBlockingType

구성 요소가 "차단"인 경우 TRUE를 설정합니다. 예를 들어 그래픽 드라이버는 구성 요소를 ActiveInD3 = 0으로 보고했습니다. 그렇지 않으면 FALSE를 설정합니다.

InitialFState

호출 시 ComponentIndex 나타내는 구성 요소의 F 상태입니다. F 상태 전환이 현재 진행 중인 경우 PreNotification=FALSE 있는 PDXGK_FSTATE_NOTIFICATION 완료 알림 콜백은 전환이 완료되면 잠시 후에 수행됩니다. 타이밍에 따라 PreNotification=TRUE 콜백이 발생할 수 있습니다. 이 경우 완료 알림 콜백 앞에 붙습니다.

ComponentGuid

해당 DXGKQAITYPE_POWERCOMPONENTINFO 응답 중에 그래픽 드라이버가 이 구성 요소에 대해 보고한 구성 요소 GUID인 GUID 값입니다.

PowerComponentMappingFlag

HIWORD는 사용자 지정 드라이버 정의 값(0 = 아니요, 1 = 예)인지를 나타냅니다. 0(아니요)이면 낮은 단어는 DXGKMT_POWER_SHARED_TYPE 열거형 값을 나타냅니다. 이러한 값은 DXGK_POWER_COMPONENT_MAPPING추가된 DXGK_POWER_COMPONENT_SHARED_DESC 형식을 사용하여 DXGKQAITYPE_POWERCOMPONENTINFO 응답 중에 그래픽 드라이버에 의해 설정됩니다.

반환 값

없음

발언

공유 전원 등록(IoCallDriver 호출) 시 PDXGK_INITIAL_COMPONENT_STATE 제공된 경우 그래픽 드라이버가 보고한 각 공유 전원 구성 요소에 대해 한 번 호출됩니다. 이 콜백의 동작은 다음과 같습니다.

이러한 호출은 IoCallDriver 반환하기 전에 발생하는 재입력 호출입니다.
이러한 호출은 DISPATCH_LEVEL 발생하므로 드라이버 코드와 데이터가 메모리 상주
이러한 콜백은 IoCallDriver가 전에 발생하므로 DXGK_GRAPHICSPOWER_REGISTER_OUTPUT 아직 채워지지 않았을 것입니다.
F-상태 전환이 현재 진행 중인 경우 사후 알림 PDXGK_FSTATE_NOTIFICATION 드라이버에 최종 상태를 경고합니다. 이러한 호출은 InitialComponentStateCb 호출 후에 발생하도록 보장됩니다. 그러나 동기화가 필요한 경우 IoCallDriver를 전에 이러한 콜백이 발생할 수 있습니다. 스핀 잠금은 IoCallDriver PDXGK_FSTATE_NOTIFICATION 처리기 주위에 있어야 합니다.