D3DKMTMapGpuVirtualAddress-Funktion (d3dkmthk.h)
D3DKMTMapGpuVirtualAddress ordnet einem GPU-Adressbereich einen bestimmten Zuordnungsbereich zu oder legt ihn in den Zustand Ungültige oder Null Zustand.
Syntax
NTSTATUS D3DKMTMapGpuVirtualAddress(
D3DDDI_MAPGPUVIRTUALADDRESS *unnamedParam1
);
Parameter
unnamedParam1
[in/out] 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 ermittelt, dass sie falsch sind. |
Diese Funktion kann auch andere NTSTATUS- Werte zurückgeben.
Bemerkungen
Der Treiber kann eine virtuelle Basis-GPU-Adresse (VA) angeben, die zugeordnet werden soll, oder den Videospeicher-Manager automatisch auswählen lassen. Wenn Sie einen Wert ungleich NULL BaseAddress angeben, muss der gesamte Bereich zwischen BaseAddress und BaseAddress+Size in einem freigegebenen Zustand liegen oder einem VA-Bereich angehören, der durch Aufrufen D3DKMTMapGpuVirtualAddress oder DxgkCbReserveGpuVirtualAddressRangeabgerufen wurde. Wenn Protection.Zero oder Protection.NoAccess- angegeben wird, kann der VA-Bereich nicht zu einem Bereich gehören, der durch Aufrufen MapGpuVirtualAddressCbabgerufen wurde.
Der Treiber kann angeben, ob die Zuordnung zusätzlich zu Leseberechtigungen, die standardmäßig vorhanden sind, Schreib- und Ausführungsberechtigungen zulassen soll.
In der Konfiguration des verknüpften Anzeigeadapters (LDA) definiert die Pagingwarteschlange eine physische GPU, deren Seitentabellen geändert werden, und der Zuordnungshandle (wenn nicht NULL) definiert, wo die Seitentabelleneinträge verweisen. Die Zuordnung kann in jedem physischen GPU-Speichersegment ansässig sein.
Der GPU VA-Bereich, der von der API zugewiesen wird, wird freigegeben, wenn die Zuordnung (die GPU VA zugeordnet ist) zerstört wird. Der VA-Bereich kann auch durch Aufrufen D3DKMTFreeGpuVirtualAddressfreigegeben werden, aber dies muss bei Bedarf mit der Zuordnungsvernichtung synchronisiert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Universal |
| Header- | d3dkmthk.h (einschließlich D3dkmthk.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |