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) |