Freigeben über


PFND3DDDI_MAPGPUVIRTUALADDRESSCB Rückruffunktion (d3dumddi.h)

pfnMapGpuVirtualAddressCb gpu virtual address (VA)-Bereiche einem bestimmten Zuordnungsbereich zuordnet oder in den Zustand Invalid oder Zero versetzt.

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 nicht abgeschlossen. Der Aufrufer muss auf den zurückgegebenen Zaunwert warten, bevor auf die Zuordnung zugegriffen wird.

Diese Funktion kann auch andere Werte zurückgeben.

Bemerkungen

Der Benutzermodustreiber kann eine virtuelle Basis-GPU-Adresse (VA) angeben, die dem Videospeicher-Manager automatisch zugeordnet oder ausgewählt werden soll. Wenn Sie einen Wert ungleich NULL BaseAddress angeben, muss der gesamte Bereich zwischen BaseAddress und BaseAddress+Size in einem freigegebenen Zustand liegen oder zu einem VA-Bereich gehören, der durch Aufrufen pfnMapGpuVirtualAddressCb oder pfnReserveGpuVirtualAddressCbabgerufen wurde. Wenn Protection.Zero oder Protection.NoAccess angegeben wird, kann der VA-Bereich nicht zu einem Bereich gehören, der durch Aufrufen pfnMapGpuVirtualAddressCbabgerufen wurde.

Der Benutzermodustreiber 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 von PFND3DDDI_FREEGPUVIRTUALADDRESSCBfreigegeben 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- Desktop
Header- d3dumddi.h (include D3dumddi.h)

Siehe auch

D3DDDI_MAPGPUVIRTUALADDRESS

pfnReserveGpuVirtualAddressCb