структура DXGKARG_SUBMITCOMMANDVIRTUAL (d3dkmddi.h)

Статья
08/07/2023

DXGKARG_SUBMITCOMMANDVIRTUAL используется для отправки буфера прямого доступа к памяти (DMA) в контекст, который поддерживает виртуальную адресацию с помощью интерфейса драйвера устройства (DDI ) DxgkDdiSubmitCommandVirtual.

Синтаксис

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

Уникальный идентификатор, который драйвер может записать в команду fence в кольцевом буфере, который представляет собой буфер, в котором буферы DMA помещаются в очередь для запуска GPU. Дополнительные сведения об этих типах идентификаторов см. в разделе Предоставление идентификаторов ограждения.

VidPnSourceId

Отсчитываемый от нуля идентификационный номер источника видеосутствий в пути топологии сети видеотрансляции (VidPN) для операции перевернуть. Этот элемент действителен, только если в элементе Flags установлен флаг битового поля Flip или FlipWithNoWait.

FlipInterval

D3DDDI_FLIPINTERVAL_TYPE типизированное значение, указывающее интервал пролистывания (т. е., если пролистывание происходит после нуля, один, два, три или четыре вертикальные синхронизации). FlipInterval действителен, только если флаг битового поля Flip установлен (то есть TRUE) в элементе Flags .

Flags

Структура DXGK_SUBMITCOMMANDFLAGS , которая определяет сведения о буфере DMA для отправки.

EngineOrdinal

Зарезервировано для последующего использования.

NodeOrdinal

Отсчитываемый от нуля индекс узла, для который создается контекст. Идентифицирует узел, если контекст имеет значение NULL.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10
Минимальная версия сервера	Windows Server 2016
Верхняя часть	d3dkmddi.h (включая D3dkmddi.h)

См. также раздел

D3DDDI_FLIPINTERVAL_TYPE

DXGK_CONTEXTINFO

DxgkDdiCreateContext

DxgkDdiSubmitCommandVirtual

Предоставление идентификаторов ограждения