PFND3DDDI_MAPGPUVIRTUALADDRESSCB Rückruffunktion (d3dumddi.h)

  • Artikel

pfnMapGpuVirtualAddressCb ordnet GPU-Adressbereiche einem bestimmten Zuordnungsbereich zu oder versetzt sie in den Zustand "Ungültig " oder " Null ".

Syntax

PFND3DDDI_MAPGPUVIRTUALADDRESSCB Pfnd3dddiMapgpuvirtualaddresscb;

HRESULT Pfnd3dddiMapgpuvirtualaddresscb(
  HANDLE hDevice,
  D3DDDI_MAPGPUVIRTUALADDRESS *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät.

unnamedParam2

[in/out] pDate ist ein Zeiger auf eine D3DDDI_MAPGPUVIRTUALADDRESS Struktur, die den auszuführenden Vorgang beschreibt.

Rückgabewert

pfnMapGpuVirtualAddressCb gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der Vorgang wurde erfolgreich abgeschlossen.
E_PENDING Der Aufruf war erfolgreich, aber der Vorgang ist noch nicht abgeschlossen. Der Aufrufer muss auf den zurückgegebenen Zaunwert warten, bevor er auf die Zuordnung zugreift.

Diese Funktion gibt möglicherweise auch andere Werte zurück.

Hinweise

Der Benutzermodustreiber kann eine virtuelle Basis-GPU-Adresse (VA) angeben, um eine zuzuordnen oder vom Videospeicher-Manager automatisch auswählen zu lassen. Wenn Sie einen BaseAddress-Wert ungleich NULL angeben, 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 pfnMapGpuVirtualAddressCb oder pfnReserveGpuVirtualAddressCb abgerufen wurde. Wenn Protection.Zero oder Protection.NoAccess angegeben ist, kann der VA-Bereich nicht zu einem Bereich gehören, der durch Aufrufen von pfnMapGpuVirtualAddressCb abgerufen wurde.

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

In der LDA-Konfiguration (Linked Display Adapter) definiert die Pagingwarteschlange eine physische GPU, deren Seitentabellen geändert werden, und das Zuordnungshandle (wenn nicht NULL) definiert, wohin die Seitentabelleneinträge verweisen. Die Zuordnung kann sich in einem beliebigen physischen GPU-Speichersegment befinden.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Desktop
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDI_MAPGPUVIRTUALADDRESS

pfnReserveGpuVirtualAddressCb