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;
  PVOID                              pDmaBuffer;
  PVOID                              pDmaBufferPrivateData;
  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.

pDmaBuffer

[in/out] Pointer to the buffer in which KMD should write the generated commands to.

pDmaBufferPrivateData

[in/out] Pointer to the buffer in which KMD can write data that is relevant to the execution of generated device instructions.

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

See also

DXGKARG_ESCAPE

DXGKDDI_ESCAPE