DXGKETW_QUEUESUBMITEVENT structure

Logs an event associated with the submission of a new queue packet (command buffer) to a GPU context.

Syntax

typedef struct _DXGKETW_QUEUESUBMITEVENT {
  EVENT_TRACE_HEADER        wmiTraceHeader;
  ULONGLONG                 hContext;
  DXGKETW_QUEUE_PACKET_TYPE PacketType;
  ULONG                     SubmitSequence;
  ULONGLONG                 DmaBufferSize;
  UINT                      AllocationListSize;
  UINT                      PatchLocationListSize;
  BOOL                      bPresent;
  ULONGLONG                 hDmaBuffer;
} DXGKETW_QUEUESUBMITEVENT;

Members

  • wmiTraceHeader
    A value, of type EVENT_TRACE_HEADER.Class.EVENT_TRACE_TYPE_START, that is used to report events to the WMI event logger.

  • hContext
    A kernel-mode handle to the GPU context that the driver submits the queue packet to.

  • PacketType
    A DXGKETW_QUEUE_PACKET_TYPE that specifies the type of work that the GPU must execute.

  • SubmitSequence
    The sequence number for this queue packet. Each queue packet is assigned a unique sequence number up to the maximum value of 32 bits, at which point the sequence numbering begins again.

  • DmaBufferSize
    The size, in bytes, of the DMA buffer that hDmaBuffer specifies.

    This member is valid only if the queue packet is of type DXGKETW_RENDER_COMMAND_BUFFER.

  • AllocationListSize
    The number of elements in the associated array of allocation lists. This number represents the number of allocation specifications to send through DMA to the graphics hardware.

    This member is valid only if the queue packet is of type DXGKETW_RENDER_COMMAND_BUFFER.

  • PatchLocationListSize
    The number of elements in the associated array of patch locations. This number represents the starting number of patch locations that the driver requests.

    This member is valid only if the queue packet is of type DXGKETW_RENDER_COMMAND_BUFFER.

  • bPresent
    A value of TRUE indicates that the queue packet contains a present operation—a flip, a bit-block transfer (bitblt), or a redirect operation. Otherwise, the value is FALSE.

    This member is valid only if the queue packet is of type DXGKETW_RENDER_COMMAND_BUFFER.

  • hDmaBuffer
    A kernel-mode handle to the allocation that holds the DMA buffer.

Requirements

Minimum supported client

Windows 8 Release Preview

Minimum supported server

Windows Server 2012

Header

Dxetwevt.h (include Dxetwevt.h)

See also

DXGKETW_QUEUE_PACKET_TYPE

 

 

Send comments about this topic to Microsoft

Build date: 7/11/2012