DXGKDDI_DISCONNECTDOORBELL Rückruffunktion (d3dkmddi.h)

Artikel
06.02.2025

Wichtig

Einige Informationen beziehen sich auf ein Vorabversionsprodukt, das vor der kommerziellen Veröffentlichung erheblich geändert werden kann. Microsoft übernimmt keine Gewährleistungen, ausdrücklich oder konkludent in Bezug auf die hier bereitgestellten Informationen.

Die DxgkDdiDisconnectDoorbell Funktion trennt eine zuvor verbundene Türglocke von einer Hardwarewarteschlange.

Syntax

DXGKDDI_DISCONNECTDOORBELL DxgkddiDisconnectdoorbell;

NTSTATUS DxgkddiDisconnectdoorbell(
  INOUT_PDXGKARG_DISCONNECTDOORBELL pArgs
)
{...}

Parameter

pArgs

[in/out] Zeiger auf eine DXGKARG_DISCONNECTDOORBELL Struktur, die die Türglocke beschreibt, um die Verbindung zu trennen.

Rückgabewert

DxgkDdiDisconnectDoorbell muss erfolgreich sein und STATUS_SUCCESS zurückgeben.

Bemerkungen

Das Betriebssystem ruft DxgkDdiDisconnectDoorbell- auf, um die Zuordnung der physischen Türbellposition, die dieser Türbell zugewiesen ist, aufzuheben. KMD sollte die Hardwarewarteschlange, die physische Adresse und den Motor der Türglocke trennen usw. Die physische Türglockenposition kann einem anderen logischen Doorbell-Objekt zugewiesen werden.

KMD sollte keine anderen Objekte zerstören oder freigeben, die mit hDoorbell verbunden sind, da das Doorbell-Objekt nicht zerstört wird und zu einem späteren Zeitpunkt wieder verbunden werden kann.

Wenn Sie von diesem DDI-Aufruf zurückkehren, führt Dxgkrnl die folgenden Schritte aus, um die Türglocke zu trennen:

Dreht den Benutzermodus DoorbellCpuVirtualAddress auf eine Dummyseite, sodass UMD nicht mehr an die physische Türkelnposition schreiben kann.
Schreibt D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY in DoorbellStatusCpuVirtualAddress, damit UMD weiß, dass die Türglocke getrennt ist.

Weitere Informationen finden Sie unter Arbeitsübermittlung im Benutzermodus.