DXGKARG_SUBMITCOMMANDVIRTUAL 구조체(d3dkmddi.h)

아티클
02/23/2024

DXGKARG_SUBMITCOMMANDVIRTUALDXgkDdiSubmitCommandVirtual DDI(디바이스 드라이버 인터페이스)를 사용하여 가상 주소 지정을 지원하는 컨텍스트에 DMA(직접 메모리 액세스) 버퍼를 제출하는 데 사용됩니다.

구문

typedef struct _DXGKARG_SUBMITCOMMANDVIRTUAL {
  HANDLE                         hContext;
  D3DGPU_VIRTUAL_ADDRESS         DmaBufferVirtualAddress;
  UINT                           DmaBufferSize;
  VOID                           *pDmaBufferPrivateData;
  UINT                           DmaBufferPrivateDataSize;
  UINT                           DmaBufferUmdPrivateDataSize;
  UINT                           SubmissionFenceId;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
  DXGK_SUBMITCOMMANDFLAGS        Flags;
  UINT                           EngineOrdinal;
  UINT                           NodeOrdinal;
} DXGKARG_SUBMITCOMMANDVIRTUAL;

멤버

hContext

DxgkDdiCreateContext에서 반환된 핸들입니다.

DmaBufferVirtualAddress

제출 프로세스의 컨텍스트에서 DMA 버퍼에 대한 가상 주소입니다.

DmaBufferSize

DMA 버퍼의 크기(바이트)입니다.

pDmaBufferPrivateData

드라이버-프라이빗 데이터 버퍼에 대한 포인터입니다.

DmaBufferPrivateDataSize

드라이버-프라이빗 데이터 버퍼의 크기(바이트)입니다.

DmaBufferUmdPrivateDataSize

SubmitCommandCb의 사용자 모드 드라이버에서 설정한 프라이빗 드라이버 데이터의 크기(바이트)입니다. SubmitCommandCb가 호출되면 DirectX 그래픽 커널은 크기가 DXGK_CONTEXTINFO::DmaBufferPrivateDataSize와 같은 프라이빗 드라이버 데이터에 대한 버퍼를 할당합니다. 이 크기는 DxgkDdiCreateContext 호출의 커널 모드 드라이버에 의해 보고되었습니다. DirectX 그래픽 커널은 SubmitCommandCb 에서 할당된 버퍼로 드라이버 프라이빗 데이터를 복사합니다.

SubmissionFenceId

드라이버가 링 버퍼의 펜스 명령에 쓸 수 있는 고유 식별자이며, GPU가 실행되도록 DMA 버퍼가 큐에 대기되는 버퍼입니다. 이러한 유형의 식별자에 대한 자세한 내용은 펜스 식별자 제공을 참조하세요.

VidPnSourceId

대칭 이동 작업을 위한 VidPN(비디오 현재 네트워크) 토폴로지 경로에 있는 비디오 원본의 0부터 시작하는 식별 번호입니다. 이 멤버는 Flip 또는 FlipWithNoWait 비트 필드 플래그가 Flags 멤버에 설정된 경우에만 유효합니다.

FlipInterval

대칭 이동 간격(즉, 0, 1, 2, 3 또는 4 세로 동기화 후에 대칭 이동이 발생하는 경우)을 나타내는 D3DDDI_FLIPINTERVAL_TYPE 형식의 값입니다. FlipInterval은 Flags 멤버에서 Flip 비트 필드 플래그(즉, TRUE)가 설정된 경우에만 유효합니다.

Flags

제출할 DMA 버퍼에 대한 정보를 식별하는 DXGK_SUBMITCOMMANDFLAGS 구조체입니다.

EngineOrdinal

다음에 사용하도록 예약됩니다.

NodeOrdinal

컨텍스트가 만들어지는 노드의 인덱스(0부터 시작)입니다. 컨텍스트가 NULL일 때 노드를 식별합니다.