DXGKDDI_CONNECTDOORBELL Rückruffunktion (d3dkmddi.h)

Artikel
05/23/2024

Wichtig

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

DxgkDdiConnectDoorbell verbindet ein zuvor erstelltes Türklingelobjekt mit einer Hardwarewarteschlange (oder stellt eine erneute Verbindung her).

Syntax

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

Parameter

pArgs

[in/out] Zeiger auf eine DXGKARG_CONNECTDOORBELL Struktur, die die zu verbindende Türklingel beschreibt.

Rückgabewert

DxgkDdiConnectDoorbell gibt STATUS_SUCCESS zurück, wenn KMD sein Türklingelobjekt erfolgreich mit der angegebenen Hardwarewarteschlange verbinden konnte. Dieser Aufruf sollte in der Regel nicht fehlschlagen. Ein zurückgegebener Fehlercode würde jedoch von gpu-verlorenen oder beendeten Arten von unwiederbringlichen Szenarien stammen.

Hinweise

Wenn UMD D3DKMTConnectDoorbell aufruft, ruft das Betriebssystem DxgkDdiConnectDoorbell auf, damit die KMD die folgenden Aktionen ausführen kann:

Geben Sie eine virtuelle CPU-Adresse an, die dem physischen Klingelort zugeordnet ist.
Stellen Sie die erforderlichen Verbindungen zwischen dem Hardwarewarteschlangenobjekt, dem Türklingelobjekt, der physischen Adresse der Türklingel, dem GPU-Scheduler usw. her.

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

Weitere Informationen finden Sie unter Benutzermodus-Arbeitsübermittlung.