DXGKDDI_CREATEDOORBELL Rückruffunktion (d3dkmddi.h)

Artikel
02/06/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.

Das Betriebssystem ruft die DxgkDdiCreateDoorbell Rückruffunktion von KMD auf, um eine Türglocke für eine Hardwarewarteschlange zu erstellen.

Syntax

DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;

NTSTATUS DxgkddiCreatedoorbell(
  INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}

Parameter

pArgs

[in/out] Zeigen Sie auf eine DXGKARG_CREATEDOORBELL Struktur, die die Türglocke beschreibt.

Rückgabewert

DxgkDdiCreateDoorbell gibt STATUS_SUCCESS zurück, wenn KMD sein Doorbell-Objekt für die angegebene Hardwarewarteschlange erfolgreich erstellen konnte, und UMD kann diese Türglocke für die Arbeitsübermittlung verwenden. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben. UMD kann die Türglocke nicht für die Arbeitsübermittlung verwenden, wenn KMD Fehlercode zurückgibt.

Bemerkungen

Wenn UMD D3DKMTCreateDoorbell aufruft, um eine Türglocke für eine Hardwarewarteschlange zu erstellen, macht das Betriebssystem eine entsprechende DxgkDdiCreateDoorbell Aufruf an KMD, sodass KMD seine Klingelstrukturen initialisieren kann.

Die DxgkDdiCreateDoorbell--Funktion von KMD sollte nur die Datenstrukturen von Doorbell erstellen und initialisieren. Es sollte diesem Doorbell-Objekt noch keine physische Türglockenposition zuweisen, da dies während eines nachfolgenden Aufrufs von DxgkDdiConnectDoorbellerfolgt. Diese faule Aufgabe stellt sicher, dass eine physische Türglocke während der Hardwarewarteschlange und der Erstellung von Türglocken nicht verwendet wird, nur um in den Fall zu gehen, dass UMD niemals Befehle an sie sendet oder zu einem späteren Zeitpunkt mit der Übermittlung von Befehlen beginnt. Auf diese Weise werden physische Türglocken nur verwendet, wenn tatsächlich erforderlich.

Weitere Informationen finden Sie unter Arbeitsübermittlung im Benutzermodus.