PDXGK_INITIAL_COMPONENT_STATE 콜백 함수(d3dkmthk.h)

아티클
02/23/2024

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 시나리오에서 F-상태 변경에 대한 그래픽 커널에서 그래픽 드라이버를 호출할 때와 마찬가지로 ComponentIndex 의 HIWORD가 어댑터 인덱스를 나타내는 LDA(연결된 디스플레이 어댑터) 시나리오에는 예외가 있습니다.

IsBlockingType

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

InitialFState

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

ComponentGuid

해당 DXGKQAITYPE_POWERCOMPONENTINFO 응답 중에 이 구성 요소에 대해 그래픽 드라이버가 보고한 구성 요소 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 처리기 주위에 있어야 합니다.