структура D3DDDI_DRIVERESCAPE_BUILDTESTCOMMANDBUFFER (d3dukmdt.h)

Статья
02/06/2025

Структура D3DDDI_DRIVERESCAPE_BUILDTESTCOMMANDBUFFER определяет escape-драйвер в режиме ядра (KMD) для создания буфера тестовой команды.

Синтаксис

typedef struct _D3DDDI_DRIVERESCAPE_BUILDTESTCOMMANDBUFFER {
  D3DDDI_DRIVERESCAPETYPE            EscapeType;
  D3DKMT_HANDLE                      hDevice;
  D3DKMT_HANDLE                      hContext;
  D3DDDI_BUILDTESTCOMMANDBUFFERFLAGS Flags;
  D3DDDI_TESTCOMMANDBUFFER           Command;
  PVOID                              pDmaBuffer;
  PVOID                              pDmaBufferPrivateData;
  UINT                               DmaBufferSize;
  UINT                               DmaBufferPrivateDataSize;
} D3DDDI_DRIVERESCAPE_BUILDTESTCOMMANDBUFFER;

Члены

EscapeType

[in] D3DDDI_DRIVERESCAPETYPE. Необходимо задать значение D3DDDI_DRIVERESCAPETYPE_BUILDTESTCOMMANDBUFFER.

hDevice

[in] Дескриптор на отображаемое устройство.

hContext

[in] Маркер контекста KMD, возвращаемый из DxgkDdiCreateContext, когда Flags.HardwareQueue равно 0, или маркер очереди оборудования KMD, возвращенный из DxgkDdiCreatehqueue при Flags.HardwareQueue равно 1.

Flags

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

Command

[in] Структура D3DDDI_TESTCOMMANDBUFFER, описывающая буфер команд для сборки.

pDmaBuffer

[in/out] Указатель на буфер, в котором KMD должен записывать созданные команды.

pDmaBufferPrivateData

[in/out] Указатель на буфер, в котором KMD может записывать данные, относящиеся к выполнению созданных инструкций устройства.

DmaBufferSize

[in/out] В входных данных задает размер в байтах буфера, на который pDmaBuffer. В выходных данных указывает количество байтов, записанных в буфер KMD. Дополнительные сведения см. в DXGKDDI_BUILDTESTCOMMANDBUFFER.

DmaBufferPrivateDataSize

[in/out] В входных данных указывает размер в байтах буфера, на который pDmaBufferPrivateData. В выходных данных указывает количество байтов, записанных в буфер KMD. Дополнительные сведения см. в DXGKDDI_BUILDTESTCOMMANDBUFFER.

Замечания

Эта структура используется тестируемыми приложениями, которые не знают особенности внутренних форматов устройств.

Дополнительные сведения см. в тестировании в режиме ядра.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 11 версии 24H2 (WDDM 3.2)
заголовка	d3dukmdt.h

См. также

DXGKARG_ESCAPE

DXGKDDI_ESCAPE

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