structure D3DDDICB_SUBMITCOMMAND (d3dumddi.h)

Article
02/06/2025

La structure D3DDDICB_SUBMITCOMMAND est utilisée pour envoyer des mémoires tampons de commande sur des contextes qui prennent en charge l’adressage virtuel de l’unité de traitement graphique (GPU).

Syntaxe

typedef struct _D3DDDICB_SUBMITCOMMAND {
  D3DGPU_VIRTUAL_ADDRESS      Commands;
  UINT                        CommandLength;
  D3DDDICB_SUBMITCOMMANDFLAGS Flags;
  UINT                        BroadcastContextCount;
  HANDLE                      BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  VOID                        *pPrivateDriverData;
  UINT                        PrivateDriverDataSize;
  UINT                        NumPrimaries;
  D3DKMT_HANDLE               WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES];
  D3DDDI_MARKERLOGTYPE        MarkerLogType;
  UINT                        RenderCBSequence;
  union {
    struct {
      UINT FirstAPISequenceNumberHigh;
      UINT CompletedAPISequenceNumberLow0Size;
      UINT CompletedAPISequenceNumberLow1Size;
      UINT BegunAPISequenceNumberLow0Size;
      UINT BegunAPISequenceNumberLow1Size;
    };
    UINT BatchedMarkerDataCount;
  };
  union {
    struct {
      const UINT *pCompletedAPISequenceNumberLow0;
      const UINT *pCompletedAPISequenceNumberLow1;
      const UINT *pBegunAPISequenceNumberLow0;
      const UINT *pBegunAPISequenceNumberLow1;
    };
    const D3DDDI_BATCHEDMARKERDATA *pBatchedMarkerData;
  };
  UINT                        Reserved;
  UINT                        NumHistoryBuffers;
  D3DKMT_HANDLE               *HistoryBufferArray;
  HANDLE                      hSyncToken;
  void                        *pReserved;
} D3DDDICB_SUBMITCOMMAND;

Membres

Commands

Adresse virtuelle GPU aux commandes envoyées au contexte pour l’exécution. Ces informations sont fournies au pilote en mode noyau pendant l’envoi de commandes et sont également utilisées à des fins de débogage.

CommandLength

Spécifie la longueur, en octets, des commandes envoyées au GPU. Ces informations sont fournies au pilote en mode noyau pendant l’envoi de commandes et sont également utilisées à des fins de débogage.

Flags

Instance de la structure D3DDDICB_SUBMITCOMMANDFLAGS.

BroadcastContextCount

Spécifie le nombre de contexte à lequel ces commandes doivent être envoyées. Ce nombre doit être d’au moins 1.

BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Spécifie le handle du contexte à exécuter les commandes spécifiées.

pPrivateDriverData

Pointeur vers les données privées du pilote à passer au pilote en mode noyau dans le cadre de cette soumission.

PrivateDriverDataSize

Taille des informations de données du pilote privé transmises. Cette taille doit être inférieure à la taille demandée par le pilote en mode noyau pour l’envoi de données de pilote privé.

NumPrimaries

Spécifie le nombre de valeurs primaires et de mémoires tampons de rémutation en cours d’écriture par les commandes envoyées. Cela est égal au nombre d’allocations dans le tableau WrittenPrimaries.

WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES]

Tableaux de handle vers les mémoires tampons primaires et de retour de permutation en cours d’écriture par les commandes envoyées.

MarkerLogType

Énumération D3DDDI_MARKERLOGTYPE qui indique le type de marqueur dans le journal Suivi d’événements pour Windows (ETW) pris en charge par le pilote d’affichage en mode utilisateur.

RenderCBSequence

Identificateur unique pour chaque appel de fonction pfnRenderCb. Commence à une valeur de 1 pour les contextes associés aux DDIS en mode utilisateur monothread et aux plages à une valeur de 0x80000001 pour les contextes associés aux DDIS en mode utilisateur libre. Le pilote d’affichage en mode utilisateur doit incrémenter la valeur de chaque pfnRenderCb l’appeler sur n’importe quel moteur.

FirstAPISequenceNumberHigh