DXGKDDI_CREATEDOORBELL fonction de rappel (d3dkmddi.h)
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.
Le système d’exploitation appelle la fonction de rappel DxgkDdiCreateDoorbell de rappel pour créer une porte d’entrée pour une file d’attente matérielle.
Syntaxe
DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;
NTSTATUS DxgkddiCreatedoorbell(
INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}
Paramètres
pArgs
[in/out] Pointeur vers une structure DXGKARG_CREATEDOORBELL qui décrit la porte d’entrée.
Valeur de retour
DxgkDdiCreateDoorbell retourne STATUS_SUCCESS si KMD a pu créer avec succès son objet doorbell pour la file d’attente matérielle spécifiée, et UMD peut utiliser cette porte d’entrée pour la soumission de travail. Sinon, elle retourne un code d’erreur NTSTATUS approprié. UMD ne peut pas utiliser la porte d’entrée pour la soumission de travail si KMD retourne un code d’échec.
Remarques
Lorsque UMD appelle D3DKMTCreateDoorbell pour créer une porte d’entrée pour une file d’attente matérielle, le système d’exploitation effectue un DxgkDdiCreateDoorbell appel à KMD afin que KMD puisse initialiser ses structures de porte-porte.
La fonction DxgkDdiCreateDoorbell de KMD ne doit créer et initialiser que ses structures de données de porte-porte. Il ne doit pas affecter un emplacement physique de porte-porte à cet objet doorbell, mais comme cela est fait lors d’un appel ultérieur à DxgkDdiConnectDoorbell. Cette affectation différée garantit qu’une porte d’entrée physique n’est pas utilisée pendant la création d’une file d’attente matérielle et d’une porte d’entrée, uniquement pour aller gaspiller dans le cas où UMD n’envoie jamais de commandes à celui-ci ou commence à envoyer des commandes ultérieurement. De cette façon, les portes d’entrée physiques sont utilisées uniquement quand elles sont réellement requises.
Pour plus d’informations, consultez soumission de travail en mode utilisateur.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 11, version 24H2 (WDDM 3.2) |
| d’en-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |