D3DKMTConnectDoorbell-Funktion (d3dkmthk.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.

D3DKMTConnectDoorbell verbindet (oder verbindet) eine zuvor erstellte Doorbell- 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ürglocke beschreibt.

Rückgabewert

D3DKMTConnectDoorbell gibt STATUS_SUCCESS zurück, wenn das Betriebssystem die Türglocke erfolgreich mit der Hardwarewarteschlange verbindet und UMD diese Türkel 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 Arten von unwiederbringlichen Szenarien beenden.

Bemerkungen

Jedes Mal, wenn die UMD neue Arbeit an die Hardwarewarteschlange übermittelt und die Türglocke klingelt, muss sie die DoorbellStatusCPUVirtualAddress lesen, um zu überprüfen, ob der Türbellring erfolgreich war. Bei Ausfall muss UMD D3DKMTConnectDoorbell- aufrufen, um die Türglocke erneut zu verbinden und dann die Übermittlung erneut zu versuchen.

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

Wenn eine Doorbellerstellt wird, initialisiert das Betriebssystem sie in einem "getrennten" Zustand und verbindet sie nur, wenn UMD D3DKMTConnectDoorbell zum ersten Mal aufruft.
Die Türglocke wurde auf Hardware "opfert", die das dedizierte Doorbell-Modell unterstützt. Das heißt, die physische Türglocke dieser Hardwarewarteschlange wurde einer anderen Hardwarewarteschlange zugewiesen. Diese Neuzuweisung ist wahrscheinlich, weil es mehr Hardwarewarteschlangen gibt, die auf der GPU erstellt werden, als physische Türglocken.
Die Türglocke wurde als Teil des Anhaltens der Hardwarewarteschlange oder des Einschaltens der GPU getrennt.

Wenn UMD D3DKMTConnectDoorbell aufruft, um die an eine Hardwarewarteschlange zugewiesene Türglocke zu verbinden, macht das Betriebssystem eine entsprechende DxgkDdiConnectDoorbell Anruf an KMD, sodass die KMD eine physische Türkel finden, diese Hardwarewarteschlange zuweisen und die erforderlichen Verbindungen zwischen der Hardwarewarteschlange, Türkel, GPU-Scheduler usw. herstellen kann.

Weitere Informationen finden Sie unter Arbeitsübermittlung im Benutzermodus.