D3DDDI_DRIVERESCAPE_BUILDTESTCOMMANDBUFFER structure (d3dukmdt.h)

The D3DDDI_DRIVERESCAPE_BUILDTESTCOMMANDBUFFER structure defines the kernel-mode driver (KMD) escape for building a test command buffer.

Syntax

typedef struct _D3DDDI_DRIVERESCAPE_BUILDTESTCOMMANDBUFFER {
  D3DDDI_DRIVERESCAPETYPE            EscapeType;
  D3DKMT_HANDLE                      hDevice;
  D3DKMT_HANDLE                      hContext;
  D3DDDI_BUILDTESTCOMMANDBUFFERFLAGS Flags;
  D3DDDI_TESTCOMMANDBUFFER           Command;
  void                               D3DKMT_PTR(
    PVOID      unnamedParam1,
    pDmaBuffer unnamedParam2
  );
  void                               D3DKMT_PTR(
    PVOID                 unnamedParam1,
    pDmaBufferPrivateData unnamedParam2
  );
  UINT                               DmaBufferSize;
  UINT                               DmaBufferPrivateDataSize;
} D3DDDI_DRIVERESCAPE_BUILDTESTCOMMANDBUFFER;

Members

EscapeType

[in] A D3DDDI_DRIVERESCAPETYPE. Must be set to D3DDDI_DRIVERESCAPETYPE_BUILDTESTCOMMANDBUFFER.

hDevice

[in] Handle to the display device.

hContext

[in] KMD context handle returned from DxgkDdiCreateContext when Flags.HardwareQueue is 0, or KMD hardware queue handle returned from DxgkDdiCreatehwqueue when Flags.HardwareQueue is 1.

Flags

[in] A D3DDDI_BUILDTESTCOMMANDBUFFERFLAGS structure that specifies flags to use when building a command buffer for kernel-mode testing.

Command

[in] A D3DDDI_TESTCOMMANDBUFFER structure that describes the command buffer to build.

void D3DKMT_PTR( PVOID unnamedParam1, pDmaBuffer unnamedParam2)

void D3DKMT_PTR( PVOID unnamedParam1, pDmaBufferPrivateData unnamedParam2)

DmaBufferSize

[in/out] On input, specifies the size in bytes of the buffer that pDmaBuffer points to. On output, specifies the number of bytes that KMD has written to the buffer. See DXGKDDI_BUILDTESTCOMMANDBUFFER for more information.

DmaBufferPrivateDataSize

[in/out] On input, specifies the size in bytes of the buffer that pDmaBufferPrivateData points to. On output, specifies the number of bytes that KMD has written to the buffer. See DXGKDDI_BUILDTESTCOMMANDBUFFER for more information.

Remarks

This structure is used by test applications that don't know the specifics of internal device formats.

For more information, see Kernel-mode testing.

Requirements

Requirement	Value
Minimum supported client	Windows 11, version 24H2 (WDDM 3.2)
Header	d3dukmdt.h

See also

DXGKARG_ESCAPE

DXGKDDI_ESCAPE