D3DKMTConnectDoorbell-Funktion (d3dkmthk.h)

  • Artikel

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.

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

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 das Türklingelobjekt 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 lost oder stop arten von unwiederbringlichen Szenarien stammen.

Hinweise

Jedes Mal, wenn die UMD neue Arbeit an die Warteschlange übermittelt und die Türklingel klingelt, muss sie pDoorbellStatusCPUVirtualAddress lesen, um zu überprüfen, ob der Klingelring erfolgreich war. Bei einem Fehler muss UMD D3DKMTConnectDoorbell aufrufen, um die Türklingel wiederherzustellen, und dann die Übermittlung erneut versuchen.

Eine Türklingel kann aus verschiedenen Gründen getrennt werden, z. B.:

  • Wenn eine Türklingel erstellt wird, initialisiert das Betriebssystem sie in einem "getrennten" Zustand und ist nur verbunden, 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 mehr Hardwarewarteschlangen auf der GPU als physische Türklingeln erstellt werden.
  • Die Türklingel wurde getrennt, um die Hardwarewarteschlange angehalten oder die GPU heruntergefahren zu haben.

Wenn UMD D3DKMTConnectDoorbell aufruft , um die einer Hardwarewarteschlange zugewiesene Türklingel zu verbinden, führt das Betriebssystem einen entsprechenden DxgkDdiConnectDoorbell-Aufruf an KMD aus, 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.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) WIN11_FUTURE
Kopfzeile d3dkmthk.h

Weitere Informationen

D3DKMT_CONNECT_DOORBELL

D3DKMTCreateDoorbell

DxgkDdiConnectDoorbell