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

Статья
02/06/2025

Структура DXGKARG_VALIDATESUBMITCOMMAND содержит аргументы, используемые в вызове DXGKDDI_VALIDATESUBMITCOMMAND.

Синтаксис

typedef struct _DXGKARG_VALIDATESUBMITCOMMAND {
  D3DGPU_VIRTUAL_ADDRESS          Commands;
  UINT                            CommandLength;
  DXGK_VALIDATESUBMITCOMMANDFLAGS Flags;
  UINT                            ContextCount;
  HANDLE                          Context[D3DDDI_MAX_BROADCAST_CONTEXT];
  VOID                            *pPrivateDriverData;
  UINT                            PrivateDriverDataSize;
  UINT                            UmdPrivateDataSize;
  UINT64                          HwQueueProgressFenceId;
} DXGKARG_VALIDATESUBMITCOMMAND;

Члены

Commands

[in] Виртуальный адрес GPU начала буфера команд.

CommandLength

[in] Длина буфера команд в байтах.

Flags

[in] Значение DXGK_VALIDATESUBMITCOMMANDFLAGS с флагами, необходимыми для проверки команды отправки.

ContextCount

[in] Количество допустимых дескрипторов в массиве контекста.

Context[D3DDDI_MAX_BROADCAST_CONTEXT]

[in] Массив дескрипторов контекстов, связанных с командами. Тип дескриптора определяется следующим образом.

Контекст — это массив контекстов драйвера, когда Flags.HardwareQueueSubmission равно 0.
Контекст — это массив аппаратных очередей драйверов, когда Flags.HardwareQueueSubmission равно 1.

pPrivateDriverData

[in/out,необязательный] Указатель на частные данные, переданные в D3DKMTSubmitCommand. Эта копия буфера и указатель — указатель в режиме ядра. См. примечания.

PrivateDriverDataSize

[in] Общий размер в байтах буфера частных данных.

UmdPrivateDataSize

[in] Количество байтов буфера частных данных, передаваемых из пользовательского режима. См. примечания.

HwQueueProgressFenceId

[in] Идентификатор, представляющий забор хода выполнения аппаратной очереди. Драйвер должен использовать этот идентификатор, чтобы убедиться, что буфер команд не был выполнен gpu при установке Flags.HardwareQueueSubmission.

Замечания

Часть буфера pPrivateDriverData, которая не передается из пользовательского режима, не инициализирована. Драйвер режима ядра может использовать эту часть для хранения собственных данных, которые можно использовать в DxgkDdiSubmitCommandVirtual.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1809
заголовка	d3dkmddi.h

См. также

D3DKMTSubmitCommand

DXGKDDI_VALIDATESUBMITCOMMAND.

Поделиться через