DXGKCB_DISCONNECTDOORBELL Rückruffunktion (d3dkmddi.h)
Wichtig
Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe wesentlich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
KMD ruft DxgkCbDisconnectDoorbell auf, um Dxgkrnl zu benachrichtigen, dass KMD eine zuvor verbundene Türklingel von einer Hardwarewarteschlange trennen muss.
Syntax
DXGKCB_DISCONNECTDOORBELL DxgkcbDisconnectdoorbell;
NTSTATUS DxgkcbDisconnectdoorbell(
INOUT_PDXGKARGCB_DISCONNECTDOORBELL pArgs
)
{...}
Parameter
pArgs
[in] Zeiger auf eine DXGKARGCB_DISCONNECTDOORBELL-Struktur , die die zu trennende Türklingel beschreibt.
Rückgabewert
DxgkCbDisconnectDoorbell gibt STATUS_INVALID_PARAMETER zurück, wenn Dxgkrnl die zugeordnete hDoorbell für hHwQueue nicht finden kann oder DisconnectReason keiner der D3DDDI_DOORBELLSTATUS_DISCONNECTED_XXX-Werte ist. In allen anderen Fällen ist diese Funktion erfolgreich, auch wenn die Türklingel bereits getrennt ist.
Hinweise
KMD ruft diese Funktion auf, um Dxgkrnl zu benachrichtigen, wenn eine Türklingel getrennt werden muss. KMD sollte berücksichtigen, dass die physische Türklingeladresse erst nach der Rückgabe von diesem Rückruf getrennt wird.
Dxgkrnl hebt die Zuordnung der virtuellen Adressen auf und markiert die Türklingel als getrennt. Dxgkrnl führt insbesondere die folgenden Schritte aus, um die Türklingel zu trennen:
- Rotiert den Benutzermodus DoorbellCpuVirtualAddress auf eine Dummyseite, sodass UMD nicht mehr in den physischen Klingelort schreiben kann.
- Schreibt DisconnectReason in DoorbellStatusCpuVirtualAddress , damit UMD weiß, dass die Türklingel getrennt ist und warum.
Weitere Informationen finden Sie unter Benutzermodus-Arbeitsübermittlung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11, Version 24H2 (WDDM 3.2) |
| Kopfzeile | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |