PFND3DDDI_OFFERALLOCATIONS2CB Rückruffunktion (d3dumddi.h)

Wird vom Anzeigetreiber für den Benutzermodus aufgerufen, um Videospeicherbelegungen für die Wiederverwendung anzubieten.

Syntax

PFND3DDDI_OFFERALLOCATIONS2CB Pfnd3dddiOfferallocations2cb;

HRESULT Pfnd3dddiOfferallocations2cb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS2 *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext). Die Direct3D-Runtime hat den Benutzermodustreiber dieses Handle als hDevice-Member der D3DDDIARG_CREATEDEVICE-Struktur bei der Geräteerstellung übergeben.

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDICB_OFFERALLOCATIONS2 Struktur, die die vom Treiber angebotenen Videospeicherbelegungen definiert.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
S_OK	Die Zuordnungen wurden erfolgreich angeboten. Hinweis: Wenn der Treiber pfnOfferAllocations2Cb nicht aufrufen muss, sollte er S_OK zurückgeben.
D3DDDIERR_DEVICEREMOVED	Der Videospeicher-Manager oder der Anzeigeminiporttreiber konnte den Vorgang nicht abschließen, da entweder ein Plug & Play (PnP) Stop-Ereignis oder ein Timeouterkennungs- und Wiederherstellungsereignis (Timeout Detection and Recovery, TDR) aufgetreten ist. Hinweis: Wenn dieser Fehlercode zurückgegeben wird, muss die aufrufende Funktion des Treibers (in der Regel die pfnOfferResources-Routine ) diesen Fehlercode an die Direct3D-Runtime zurückgeben.
E_INVALIDARG	Ein ungültiger Parameter wurde angegeben.

Hinweise

Der Benutzermodusanzeigetreiber ruft pfnOfferAllocations2Cb auf, um das Microsoft DirectX-Grafikkernsubsystem zu benachrichtigen, dass es nach Abschluss aller zuvor übermittelten Rendervorgänge den Speicher der Zuordnungen für andere Prozesse zur Verwendung bereitstellen kann.

Nachdem der Treiber pfnOfferAllocations2Cb aufgerufen hat, um eine Zuordnung zur Wiederverwendung anzubieten, muss er pfnReclaimAllocations3Cb aufrufen, bevor er die Zuordnung sperrt oder für Renderingvorgänge übermittelt.

pfnOfferAllocations2Cb-Funktionen sind identisch mit pfnOfferAllocationsCb, mit der Ausnahme, dass Flags über den pData-Parameter berücksichtigt werden.

Anforderungen

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

Weitere Informationen

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS2

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocations3Cb