struktur DXGKARG_SUBMITCOMMANDVIRTUAL (d3dkmddi.h)

Artikel
02/26/2024

DXGKARG_SUBMITCOMMANDVIRTUAL digunakan untuk mengirimkan buffer akses memori langsung (DMA) ke konteks yang mendukung alamat virtual dengan antarmuka driver perangkat DxgkDdiSubmitCommandVirtual(DDI).

Sintaks

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;

Anggota

hContext

Handel yang dikembalikan dari DxgkDdiCreateContext.

DmaBufferVirtualAddress

Alamat virtual untuk buffer DMA dalam konteks proses pengiriman.

DmaBufferSize

Ukuran buffer DMA dalam byte.

pDmaBufferPrivateData

Penunjuk ke buffer data pribadi driver.

DmaBufferPrivateDataSize

Ukuran buffer data pribadi driver dalam byte.

DmaBufferUmdPrivateDataSize

Ukuran data driver privat, dalam byte, yang diatur oleh driver mode pengguna di SubmitCommandCb. Ketika SubmitCommandCb dipanggil, kernel grafis DirectX mengalokasikan buffer untuk data driver privat dengan ukuran yang sama dengan DXGK_CONTEXTINFO::DmaBufferPrivateDataSize. Ukuran ini dilaporkan oleh driver mode kernel dalam panggilan DxgkDdiCreateContext . Kernel grafik DirectX menyalin data pribadi driver dari SubmitCommandCb ke buffer yang dialokasikan.

SubmissionFenceId

Pengidentifikasi unik yang dapat ditulis driver ke dalam perintah pagar di buffer cincin, yang merupakan buffer tempat buffer DMA diantrekan agar GPU berjalan. Untuk informasi selengkapnya tentang jenis pengidentifikasi ini, lihat Menyediakan Pengidentifikasi Pagar.

VidPnSourceId

Nomor identifikasi berbasis nol dari sumber video yang ada di jalur topologi video present network (VidPN) untuk operasi balik. Anggota ini hanya valid ketika bendera bidang bit Flip atau FlipWithNoWait diatur dalam anggota Bendera .

FlipInterval

Nilai D3DDDI_FLIPINTERVAL_TYPE-ketik yang menunjukkan interval balik (yaitu, jika flip terjadi setelah sinkronisasi vertikal nol, satu, dua, tiga, atau empat). FlipInterval hanya valid jika bendera Flip bit-field diatur (yaitu TRUE) di anggota Bendera .

Flags

Struktur DXGK_SUBMITCOMMANDFLAGS yang mengidentifikasi informasi tentang buffer DMA untuk dikirimkan.

EngineOrdinal

Disiapkan untuk penggunaan masa mendatang.

NodeOrdinal

Indeks berbasis nol dari simpul tempat konteks dibuat. Mengidentifikasi simpul ketika konteksnya adalah NULL.