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