D3DKMTReserveGpuVirtualAddress-Funktion (d3dkmthk.h)
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 |