DXGKDDI_CREATEDOORBELL fonction de rappel (d3dkmddi.h)

Article
05/23/2024

Important

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

Le système d’exploitation appelle la fonction de rappel DxgkDdiCreateDoorbell de KMD pour créer une sonnette 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 sonnette de porte.

Valeur retournée

DxgkDdiCreateDoorbell retourne STATUS_SUCCESS si KMD a réussi à créer son objet de sonnette pour la file d’attente matérielle spécifiée et qu’UMD peut utiliser cette sonnette pour la soumission de travaux. Sinon, il retourne un code d’erreur NTSTATUS approprié. L’UMD ne peut pas utiliser la sonnette pour la soumission du travail si KMD retourne un code d’échec.

Remarques

Quand UMD appelle D3DKMTCreateDoorbell pour créer une sonnette pour une file d’attente matérielle, le système d’exploitation effectue un appel DxgkDdiCreateDoorbell correspondant à KMD afin que KMD puisse initialiser ses structures de sonnette de porte.

La fonction DxgkDdiCreateDoorbell de KMD doit uniquement créer et initialiser ses structures de données de sonnette. Il ne doit pas encore attribuer d’emplacement de sonnette physique à cet objet doorbell, comme cela est effectué lors d’un appel ultérieur à DxgkDdiConnectDoorbell. Cette affectation paresseux garantit qu’une sonnette physique n’est pas utilisée lors de la création de la file d’attente matérielle et de la sonnette, mais qu’elle est gaspiller dans le cas où UMD ne lui envoie jamais de commandes ou commence à envoyer des commandes ultérieurement. De cette façon, les sonnettes physiques ne sont utilisées qu’en cas de besoin réel.

Pour plus d’informations, consultez Soumission de travail en mode utilisateur.