DXGKDDI_CONNECTDOORBELL 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.

DxgkDdiConnectDoorbell verbindet (oder verbindet) ein zuvor erstelltes Doorbell-Objekt mit einer Hardwarewarteschlange.

Syntax

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

Parameter

pArgs

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

Rückgabewert

DxgkDdiConnectDoorbell- gibt STATUS_SUCCESS zurück, wenn KMD sein Doorbell-Objekt erfolgreich mit der angegebenen Hardwarewarteschlange verbinden konnte. Dieser Aufruf sollte in der Regel nicht fehlschlagen. Ein zurückgegebener Fehlercode würde jedoch von GPU verloren gegangen oder beendete Arten von unwiederbringlichen Szenarien.

Bemerkungen

Wenn UMD D3DKMTConnectDoorbellaufruft, ruft das Betriebssystem DxgkDdiConnectDoorbell auf, damit die KMD folgendes ausführen kann:

Stellen Sie eine virtuelle CPU-Adresse bereit, die der physischen Türglockenposition zugeordnet ist.
Stellen Sie die erforderlichen Verbindungen zwischen dem Hardwarewarteschlangenobjekt, dem Doorbell-Objekt, der physischen Adresse der Türglocke, dem GPU-Zeitplan usw. her.

Bei der Rückgabe von dieser DDI sollte KMD diese physische Adresse als für diese bestimmte Hardwarewarteschlange reserviert betrachten. Das Betriebssystem hat jedoch keine Eindeutigkeitsanforderung für die physische Adresse der Türglocke. Das heißt, KMD kann je nach Hardwareimplementierung die gleiche physische Adresse mit mehreren logischen Türglocken/Hardwarewarteschlangen teilen. Beispielsweise kann eine Hardware die gleiche physische Adresse allen Hardwarewarteschlangen eines einzelnen Hardwarekontexts zuweisen. Es ist sogar möglich, dass mehrere logische Türglocken dieselbe physische Seite mit 4 KB teilen, aber einen eindeutigen Offset innerhalb der Seite verwenden.

Weitere Informationen finden Sie unter Arbeitsübermittlung im Benutzermodus.