DXGKDDI_CREATEDOORBELL Rückruffunktion (d3dkmddi.h)

Artikel
05/23/2024

Wichtig

Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe erheblich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Syntax

DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;

NTSTATUS DxgkddiCreatedoorbell(
  INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}

Parameter

pArgs

[ein/aus] Zeiger auf eine DXGKARG_CREATEDOORBELL Struktur, die die Türklingel beschreibt.

Rückgabewert

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

Hinweise

Wenn UMD D3DKMTCreateDoorbell aufruft , um eine Türklingel für eine Hardwarewarteschlange zu erstellen, sendet das Betriebssystem einen entsprechenden DxgkDdiCreateDoorbell-Aufruf an KMD, sodass KMD seine Türklingelstrukturen initialisieren kann.

Die DxgkDdiCreateDoorbell-Funktion von KMD sollte nur die Türklingeldatenstrukturen erstellen und initialisieren. Diesem Klingelobjekt sollte noch keine physische Klingelposition zugewiesen werden, da dies bei einem nachfolgenden Aufruf von DxgkDdiConnectDoorbell geschieht. Diese faule Zuweisung stellt sicher, dass eine physische Türklingel während der Erstellung der Hardwarewarteschlange und der Türklingel nicht verbraucht wird, nur für den Fall, dass UMD nie Befehle an sie übermittelt oder zu einem späteren Zeitpunkt mit der Übermittlung von Befehlen beginnt. Auf diese Weise werden physische Türklingeln nur dann verwendet, wenn sie tatsächlich benötigt werden.

Weitere Informationen finden Sie unter Arbeitsübermittlung im Benutzermodus.