D3DKMTMapGpuVirtualAddress-Funktion (d3dkmthk.h)

  • Artikel

D3DKMTMapGpuVirtualAddress ordnet einen virtuellen GPU-Adressbereich einem bestimmten Zuordnungsbereich zu oder versetzt ihn in den Status Ungültig oder Null .

Syntax

NTSTATUS D3DKMTMapGpuVirtualAddress(
  D3DDDI_MAPGPUVIRTUALADDRESS *unnamedParam1
);

Parameter

unnamedParam1

[ein/aus] pData ist ein Zeiger auf eine D3DDDI_MAPGPUVIRTUALADDRESS Struktur, die den Vorgang beschreibt.

Rückgabewert

Rückgabecode Beschreibung
STATUS_SUCCESS Der Gerätekontext wurde erfolgreich erstellt.
STATUS_INVALID_PARAMETER Parameter wurden überprüft und als falsch ermittelt.

Diese Funktion kann auch andere NTSTATUS-Werte zurückgeben.

Hinweise

Der Treiber kann eine virtuelle Basisadresse (VIRTUAL Address, VA) für die Zuordnung angeben oder vom Videospeicher-Manager automatisch auswählen lassen. Beim Angeben eines BaseAddress-Werts ohne NULL muss sich der gesamte Bereich von BaseAddress bis BaseAddress+Size in einem freigegebenen Zustand befinden oder zu einem VA-Bereich gehören, der durch Aufrufen von D3DKMTMapGpuVirtualAddress oder DxgkCbReserveGpuVirtualAddressRange abgerufen wurde. Wenn Protection.Zero oder Protection.NoAccess angegeben wird, kann der VA-Bereich nicht zu einem Bereich gehören, der durch aufrufen von MapGpuVirtualAddressCb abgerufen wurde.

Der Treiber kann angeben, ob die Zuordnung Schreib- und Ausführungsrechte zusätzlich zu Leseberechtigungen zulassen soll, die standardmäßig immer vorhanden sind.

In der Konfiguration des verknüpften Anzeigeadapters (Linked Display Adapter, LDA) definiert die Pagingwarteschlange eine physische GPU, deren Seitentabellen geändert werden, und der Zuordnungshandle (falls nicht NULL) definiert, wohin die Seitentabelleneinträge verweisen. Die Zuordnung kann sich in jedem physischen GPU-Speichersegment befinden.

Der GPU-VA-Bereich, der von der API zugewiesen wird, wird freigegeben, wenn die Zuordnung (der GPU-VA wird zugeordnet) zerstört wird. Der VA-Bereich kann auch durch Aufrufen von D3DKMTFreeGpuVirtualAddress freigegeben werden, dies muss jedoch bei Bedarf mit der Zuordnungsvernichtung synchronisiert werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Universell
Header d3dkmthk.h (einschließlich D3dkmthk.h)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

DxgkCbReserveGpuVirtualAddressRange