PFND3DDDI_OFFERALLOCATIONSCB Rückruffunktion (d3dumddi.h)

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

Syntax

PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;

HRESULT Pfnd3dddiOfferallocationscb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS *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_OFFERALLOCATIONS-Struktur , die die vom Treiber angebotenen Videospeicherzuordnungen definiert.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
S_OK	Die Zuordnungen wurden erfolgreich angeboten. Hinweis: Wenn der Treiber pfnOfferAllocationsCb 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 pfnOfferAllocationsCb 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 pfnOfferAllocationsCb aufgerufen hat, um eine Zuordnung zur Wiederverwendung anzubieten, muss er pfnReclaimAllocationsCb aufrufen, bevor er die Zuordnung sperrt oder für Renderingvorgänge übermittelt.

Anforderungen

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

Weitere Informationen

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocationsCb