DXGKARG_CREATEDOORBELL structure (d3dkmddi.h)

Article
05/23/2024

Important

Certaines informations se rapportent à un produit de préversion qui peut être considérablement modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

La structure DXGKARG_CREATEDOORBELL contient des paramètres pour la fonction de rappel DxgkDdiCreateDoorbell de 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éé lors d’un appel précédent à DxgkddiCreateHwQueue.

hDoorbell

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

PrivateDriverDataSize

[in] Taille, en octets, des données privées du pilote associées à la sonnette.

PrivateDriverData

[entrée/sortie] Pointeur vers les données privées du pilote associées à la sonnette.

hRingBuffer

[in] Gérez l’allocation de mémoire tampon en anneau précédemment créée par UMD. Cette allocation est visible par GPU et déjà résidente. L’indicateur ResizeRingBufferOperation est un indicateur d’UMD à KMD indiquant qu’une sonnette est en cours de recréation 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 comme 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 bit de valeurs DXGKARG_CREATEDOORBELL_FLAGS spécifiant les indicateurs de création de sonnette.