D3DKMT_CREATE_DOORBELL 구조체(d3dkmthk.h)

아티클
05/23/2024

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

구문

typedef struct _D3DKMT_CREATE_DOORBELL {
  D3DKMT_HANDLE                hHwQueue;
  D3DKMT_HANDLE                hRingBuffer;
  D3DKMT_HANDLE                hRingBufferControl;
  D3DKMT_CREATE_DOORBELL_FLAGS Flags;
  UINT                         PrivateDriverDataSize;
  void                         D3DKMT_PTR(
    VOID              *unnamedParam1,
    PrivateDriverData unnamedParam2
  );
  void                         D3DKMT_PTR(
    VOID                      *unnamedParam1,
    DoorbellCPUVirtualAddress unnamedParam2
  );
  void                         D3DKMT_PTR(
    VOID                               *unnamedParam1,
    DoorbellSecondaryCPUVirtualAddress unnamedParam2
  );
  void                         D3DKMT_PTR(
    VOID                            *unnamedParam1,
    DoorbellStatusCPUVirtualAddress unnamedParam2
  );
  void                         D3DKMT_PTR(
    VOID                                                 *unnamedParam1,
    HwQueueProgressFenceLastQueuedValueCPUVirtualAddress unnamedParam2
  );
  D3DKMT_HANDLE                hDoorbell;
} D3DKMT_CREATE_DOORBELL;

멤버

hHwQueue

[in] D3DKMTCreateHwQueue에 대한 이전 호출에서 만든 하드웨어 큐 개체의 UMD 핸들입니다. 이 핸들은 초인종을 할당해야 하는 하드웨어 큐를 식별합니다.

hRingBuffer

[in] UMD가 이전에 만든 링 버퍼 할당에 대한 UMD 핸들입니다. 할당은 GPU가 표시되고 이미 상주해야 합니다. Dxgkrnl 은 해당 DxgkDdiCreateDoorbell 호출에서 이 할당의 GPU VA(가상 주소) 및 크기를 KMD에 전달합니다. ResizeRingBufferOperation 플래그는 크기가 조정된 새로운 링 버퍼를 사용하여 이 하드웨어 큐에 대해 초인종을 다시 만드는 UMD에서 KMD로의 힌트입니다.

hRingBufferControl

[in/optional] UMD에서 이전에 만든 링 버퍼 컨트롤 할당에 대한 UMD 핸들입니다. UMD 및 KMD는 이 할당을 제어 영역으로 사용하여 필요한 경우 링 버퍼 읽기/쓰기 포인터 위치를 저장할 수 있습니다. 할당은 UMD가 D3DKMTCreateDoorbell을 호출할 때 GPU가 표시되고 이미 상주해야 합니다. Dxgkrnl 은 해당 DxgkDdiCreateDoorbell 호출에서 GPU VA 및 이 할당의 크기를 KMD에 전달합니다.

Flags

[in/optional] 초인종 만들기 플래그를 지정하는 D3DKMT_CREATE_DOORBELL_FLAGS 값의 비트 필드입니다.

PrivateDriverDataSize

[in] pPrivateDriverData 가 가리키는 프라이빗 드라이버 데이터의 크기(바이트)입니다.

void D3DKMT_PTR( VOID *unnamedParam1, PrivateDriverData unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, DoorbellCPUVirtualAddress unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, DoorbellSecondaryCPUVirtualAddress unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, DoorbellStatusCPUVirtualAddress unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, HwQueueProgressFenceLastQueuedValueCPUVirtualAddress unnamedParam2)

hDoorbell

[out] 새로 만든 초인종 개체에 대한 런타임 핸들입니다.