DXGKDDI_CONNECTDOORBELL Rückruffunktion (d3dkmddi.h)

Artikel
02/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.

DxgkDdiConnectDoorbell verbindet ein zuvor erstelltes Klingelobjekt mit einer Hardwarewarteschlange.

Syntax

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

Parameter

pArgs

[ein/aus] 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 verlorenen oder beendeten Arten von unwiederbringlichen Szenarien stammen.

Hinweise

Wenn UMD D3DKMTConnectDoorbell aufruft, ruft das Betriebssystem DxgkDdiConnectDoorbell auf, sodass der 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-Planer 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 je nach Hardwareimplementierung die gleiche physische Adresse mit mehreren logischen Türklingeln/Hardwarewarteschlangen verwenden. Beispielsweise kann einige Hardware alle Hardwarewarteschlangen eines einzelnen Hardwarekontexts die gleiche physische Adresse zuweisen. Es ist sogar möglich, dass mehrere logische Türklingeln dieselbe physische Seite mit 4 KB nutzen, aber einen eindeutigen Offset innerhalb der Seite verwenden.