structure DXGKARG_CREATEDOORBELL (d3dkmddi.h)

Article
02/06/2025

Important

Certaines informations concernent un produit de préversion qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne les informations fournies ici.

La structure DXGKARG_CREATEDOORBELL contient des paramètres pour la fonction de rappel DxgkDdiCreateDoorbell kmD.

Syntaxe

typedef struct _DXGKARG_CREATEDOORBELL {
  HANDLE                       hHwQueue;
  HANDLE                       hDoorbell;
  UINT                         PrivateDriverDataSize;
  void                         *PrivateDriverData;
  HANDLE                       hRingBuffer;
  HANDLE                       hRingBufferControl;
  DXGKARG_CREATEDOORBELL_FLAGS Flags;
} DXGKARG_CREATEDOORBELL;

Membres

hHwQueue

[in] Gérez un objet de file d’attente matérielle KMD, créé dans un appel précédent à DxgkddiCreateHwQueue.

hDoorbell

[in/out] En tant qu’entrée, contient la poignée du runtime à la porte d’entrée. KMD peut stocker le handle d’entrée dans ses structures de suivi. Comme sortie, lorsque KMD termine la création de la porte d’entrée, hDoorbell contient la poignée en mode noyau de KMD à la porte.

PrivateDriverDataSize

[in] Taille, en octets, des données privées du pilote associées à la porte d’entrée.

PrivateDriverData

[in/out] Pointeur vers les données privées du pilote associées à la porte.

hRingBuffer

[in] Gérez l’allocation de mémoire tampon en anneau créée précédemment par UMD. Cette allocation est visible par GPU et déjà résidente. L’indicateur ResizeRingBufferOperation est un indicateur de UMD à KMD indiquant qu’une porte d’entrée est recréée pour cette file d’attente matérielle avec une nouvelle mémoire tampon en anneau redimensionnée.

hRingBufferControl

[in] Handle KMD vers une allocation de contrôle de mémoire tampon en anneau précédemment créée par UMD. UMD et KMD peuvent utiliser cette allocation en tant que zone de contrôle pour stocker les emplacements des pointeurs de lecture/écriture de mémoire tampon en anneau si nécessaire. L’allocation doit être visible par GPU et déjà résidente.

Flags

Champ de bits de DXGKARG_CREATEDOORBELL_FLAGS valeurs spécifiant les indicateurs de création de porte d’entrée.