Freigeben über

D3DKMTConnectDoorbell-Funktion (d3dkmthk.h)

  • Artikel

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.

D3DKMTConnectDoorbell verbindet eine zuvor erstellte Türklingel mit einer Hardwarewarteschlange.

Syntax

NTSTATUS D3DKMTConnectDoorbell(
  D3DKMT_CONNECT_DOORBELL *unnamedParam1
);

Parameter

unnamedParam1

[in] Zeiger auf eine *D3DKMT_CONNECT_DOORBELL-Struktur* , die die zu verbindende Türklingel beschreibt.

Rückgabewert

D3DKMTConnectDoorbell gibt STATUS_SUCCESS zurück, wenn das Betriebssystem die Türklingel erfolgreich mit der Hardwarewarteschlange verbindet und UMD diese Türklingel für die Arbeitsübermittlung verwenden kann. In der Regel sollte dieser Aufruf nicht fehlschlagen. Ein Fehlercode würde jedoch von gpu verloren gegangen sein oder verschiedene unwiederbringliche Szenarien beenden.

Hinweise

Jedes Mal, wenn die UMD neue Arbeit an die Hardwarewarteschlange sendet und die Türklingel klingelt, muss sie die DoorbellStatusCPUVirtualAddress lesen, um zu überprüfen, ob der Klingelring erfolgreich war. Bei Einem Fehler muss UMD D3DKMTConnectDoorbell aufrufen, um die Türklingel erneut zu verbinden, und versuchen Sie dann die Übermittlung erneut.

Eine Türklingel kann aus mehreren Gründen getrennt werden:

  • Wenn eine Türklingel erstellt wird, initialisiert das Betriebssystem sie in einem "getrennten" Zustand und stellt nur eine Verbindung her, wenn UMD D3DKMTConnectDoorbell zum ersten Mal aufruft.
  • Die Türklingel wurde auf Hardware "opfert", die das dedizierte Türklingelmodell unterstützt. Das heißt, die physische Türklingel dieser Hardwarewarteschlange wurde einer anderen Hardwarewarteschlange zugewiesen. Diese Neuzuweisung liegt wahrscheinlich daran, dass auf der GPU mehr Hardwarewarteschlangen als physische Klingeln erstellt werden.
  • Die Türklingel wurde getrennt, während die Hardwarewarteschlange angehalten oder die GPU heruntergefahren wurde.

Wenn UMD D3DKMTConnectDoorbell aufruft , um die Einer Hardwarewarteschlange zugewiesene Türklingel zu verbinden, ruft das Betriebssystem einen entsprechenden DxgkDdiConnectDoorbell-Aufruf an KMD ab, sodass der KMD eine physische Türklingel finden, sie dieser Hardwarewarteschlange zuweisen und die erforderlichen Verbindungen zwischen Hardwarewarteschlange, Türklingel, GPU-Planer usw. herstellen kann.

Weitere Informationen finden Sie unter Arbeitsübermittlung im Benutzermodus.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 24H2 (WDDM 3.2)
Kopfzeile d3dkmthk.h

Weitere Informationen

D3DKMT_CONNECT_DOORBELL

D3DKMTCreateDoorbell

DxgkDdiConnectDoorbell