DXGKDDI_DISCONNECTDOORBELL fonction de rappel (d3dkmddi.h)

Article
02/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.

La fonction DxgkDdiDisconnectDoorbell déconnecte un objet de sonnette précédemment connecté d’une file d’attente matérielle.

Syntaxe

DXGKDDI_DISCONNECTDOORBELL DxgkddiDisconnectdoorbell;

NTSTATUS DxgkddiDisconnectdoorbell(
  INOUT_PDXGKARG_DISCONNECTDOORBELL pArgs
)
{...}

Paramètres

pArgs

[in/out] Pointeur vers une structure DXGKARG_DISCONNECTDOORBELL qui décrit la sonnette à déconnecter.

Valeur retournée

DxgkDdiDisconnectDoorbell doit réussir et retourner STATUS_SUCCESS.

Remarques

Le système d’exploitation appelle DxgkDdiDisconnectDoorbell pour annuler le mappage de l’emplacement physique de sonnette attribué à cette sonnette. KMD doit déconnecter la file d’attente matérielle, l’adresse physique et le moteur de la sonnette, etc. L’emplacement physique de la sonnette peut être attribué à un autre objet de sonnette logique.

KMD ne doit pas détruire ou libérer d’autres objets associés à hDoorbell , car l’objet de sonnette n’est pas détruit et peut être reconnecté ultérieurement.

Au retour de cet appel DDI, Dxgkrnl effectue les étapes suivantes pour déconnecter la sonnette :

Fait pivoter le doorbellCpuVirtualAddress en mode utilisateur vers une page factice afin qu’UMD ne puisse plus écrire dans l’emplacement physique de la sonnette.
Écrit D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY dans DoorbellStatusCpuVirtualAddress afin que l’UMD sache que la sonnette est déconnectée.