DXGKARG_CONNECTDOORBELL 구조체(d3dkmddi.h)

아티클
05/23/2024

중요

일부 정보는 상용 출시 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

DXGKARG_CONNECTDOORBELL 구조체에는 DxgkDdiConnectDoorbell에 대한 매개 변수가 포함되어 있습니다.

구문

typedef struct _DXGKARG_CONNECTDOORBELL {
  HANDLE                        hDoorbell;
  DXGKARG_CONNECTDOORBELL_FLAGS Flags;
  void                          *KernelCpuVirtualAddress;
  void                          *SecondaryKernelCpuVirtualAddress;
  D3DDDI_DOORBELLSTATUS         Status;
} DXGKARG_CONNECTDOORBELL;

멤버

hDoorbell

[in] 이전에 DxgkDdiCreateDoorbell을 사용하여 만든 초인종 개체에 대한 KMD 핸들입니다.

Flags

[in] 초인종 연결 플래그를 지정하는 DXGKARG_CONNECTDOORBELL_FLAGS 값의 비트 필드입니다. UMD가 RequireSecondaryCpuVA 플래그를 사용하여 이 초인종을 만든 경우 Dxgkrnl은 이 DDI 에서 RequireSecondaryAddress 플래그를 설정하여 KMD에 이 초인종에 두 개의 실제 주소가 필요하다는 것을 알릴 수 있습니다.

KernelCpuVirtualAddress

[out] KMD가 이 초인종에 할당하려는 실제 주소에 매핑된 커널 모드 CPU 가상 주소입니다. Dxgkrnl 은 이 주소를 D3DKMTCreateDoorbell의 UMD에 제공된 프로세스 주소 공간 CPU 가상 주소에 매핑합니다. UMD는 이 주소에 특정 값을 작성하여 HHwQueue에서 새 작업 제출을 GPU 스케줄러에 알리기 위해 효과적으로 "초인종 울림"을 씁니다.

SecondaryKernelCpuVirtualAddress

[out/optional] 필요한 경우 KMD가 이 초인종에 할당하려는 보조 물리적 주소에 매핑된 커널 모드 CPU 가상 주소입니다.

Status

[out] KMD에서 dxgkrnl이 pDoorbellStatusCpuVirtualAddress가 가리키는 UMD 표시 페이지에 쓰려는 D3DDDI_DOORBELLSTATUS 값입니다. 이 값은 D3DDDI_DOORBELL_STATUS_CONNECTED 또는 D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY 수 있습니다.