D3DKMTReserveGpuVirtualAddress-Funktion (d3dkmthk.h)

  • Artikel

D3DKMTReserveGpuVirtualAddress reserviert einen Adressbereich im aktuellen virtuellen Gpu-Adressraum (Process Graphics Processing Unit). Der Adressbereich ist nur reserviert, es gibt keinen tatsächlichen Speicher dahinter.

Der Treiber kann die virtuelle Basisadresse der GPU auswählen, die für die Reservierung verwendet werden soll, indem er einen Wert ungleich NULL für BaseAddress angibt. Der Videospeicher-Manager verwendet den angegebenen Bereich, sofern er verfügbar ist. Wenn sich der Bereich mit einem vorhandenen Bereich überschneidet, schlägt der Vorgang fehl. Der Treiber übergibt möglicherweise einen NULL-Wert im BaseAddress-Member , damit der Videospeicher-Manager eine Basisadresse auswählen kann.

Wenn der Treiber sich dafür entscheidet, dass der Videospeicher-Manager eine Basisadresse für den virtuellen GPU-Adressbereich auswählen kann, kann er den Bereich einschränken, den der Videospeicher-Manager berücksichtigen wird, indem er nicht NULL-Werte für MinimumAddress und MaximumAddress angibt. Der Videospeicher-Manager stellt sicher, dass der zugeordnete virtuelle GPU-Adressbereich vollständig im Bereich enthalten ist. Der Treiber kann nur eine MinimumAddress angeben, und der Treiber leitet daraus ab , dass MaximumAddress das Ende des Adressraums ist. Wenn nur eine MaximumAddress angegeben wird, wird die MinimumAddress auf 0 abgeleitet.

Syntax

NTSTATUS D3DKMTReserveGpuVirtualAddress(
  D3DDDI_RESERVEGPUVIRTUALADDRESS *unnamedParam1
);

Parameter

unnamedParam1

pData [ein, aus]

Ein Zeiger auf eine D3DDDI_RESERVEGPUVIRTUALADDRESS 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.

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