DXGKDDI_DISCONNECTDOORBELL fonction de rappel (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 fonction DxgkDdiDisconnectDoorbell déconnecte une porte d’entrée précédemment connectée à partir 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 porte d’entrée à déconnecter.

Valeur de retour

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 la porte d’entrée affecté à cette porte d’entrée. KMD doit déconnecter la file d’attente matérielle, l’adresse physique de porte d’entrée et le moteur, etc. L’emplacement physique de la porte d’entrée peut être affecté à un autre objet de porte d’entrée logique.

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

À l’issue de cet appel DDI, Dxgkrnl effectue les étapes suivantes pour déconnecter la porte d’entrée :

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

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