structure DXGKARG_SUBMITCOMMANDVIRTUAL (d3dkmddi.h)

Article
02/26/2024

DXGKARG_SUBMITCOMMANDVIRTUAL est utilisé pour envoyer une mémoire tampon d’accès direct à la mémoire (DMA) à un contexte qui prend en charge l’adressage virtuel avec l’interface de pilote de périphérique DxgkDdiSubmitCommandVirtual.

Syntaxe

typedef struct _DXGKARG_SUBMITCOMMANDVIRTUAL {
  HANDLE                         hContext;
  D3DGPU_VIRTUAL_ADDRESS         DmaBufferVirtualAddress;
  UINT                           DmaBufferSize;
  VOID                           *pDmaBufferPrivateData;
  UINT                           DmaBufferPrivateDataSize;
  UINT                           DmaBufferUmdPrivateDataSize;
  UINT                           SubmissionFenceId;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
  DXGK_SUBMITCOMMANDFLAGS        Flags;
  UINT                           EngineOrdinal;
  UINT                           NodeOrdinal;
} DXGKARG_SUBMITCOMMANDVIRTUAL;

Membres

hContext

Handle retourné par DxgkDdiCreateContext.

DmaBufferVirtualAddress

Adresse virtuelle de la mémoire tampon DMA dans le contexte du processus d’envoi.

DmaBufferSize

Taille de la mémoire tampon DMA en octets.

pDmaBufferPrivateData

Pointeur vers la mémoire tampon de données privée du pilote.

DmaBufferPrivateDataSize

Taille de la mémoire tampon de données privée du pilote en octets.

DmaBufferUmdPrivateDataSize

Taille des données de pilote privé, en octets, qui ont été définies par le pilote de mode utilisateur dans SubmitCommandCb. Lorsque SubmitCommandCb est appelé, le noyau graphique DirectX alloue une mémoire tampon pour les données du pilote privé d’une taille égale à DXGK_CONTEXTINFO ::DmaBufferPrivateDataSize. Cette taille a été signalée par le pilote en mode noyau dans l’appel DxgkDdiCreateContext . Le noyau graphique DirectX copie les données privées du pilote de SubmitCommandCb vers la mémoire tampon allouée.

SubmissionFenceId

Identificateur unique que le pilote peut écrire dans la commande de clôture dans la mémoire tampon en anneau, qui est la mémoire tampon où les mémoires tampons DMA sont mises en file d’attente pour que le GPU s’exécute. Pour plus d’informations sur ces types d’identificateurs, consultez Fournir des identificateurs de clôture.

VidPnSourceId

Numéro d’identification de base zéro de la source présente de la vidéo dans un chemin d’accès d’une topologie de réseau présent vidéo (VidPN) pour une opération de retournement. Ce membre est valide uniquement lorsque l’indicateur de champ de bits Flip ou FlipWithNoWait est défini dans le membre Indicateurs .

FlipInterval

Valeur de type D3DDDI_FLIPINTERVAL_TYPE qui indique l’intervalle de basculement (autrement dit, si le basculement se produit après zéro, une, deux, trois ou quatre synchronisations verticales). FlipInterval n’est valide que si l’indicateur de champ de bits flip est défini (c’est-à-dire TRUE) dans le membre Flags .

Flags

Une structure DXGK_SUBMITCOMMANDFLAGS qui identifie des informations sur la mémoire tampon DMA à envoyer.

EngineOrdinal

Réservé pour un usage futur.

NodeOrdinal

Index de base zéro du nœud pour lequel le contexte est créé. Identifie le nœud lorsque le contexte a la valeur NULL.