PFND3DDDI_OFFERALLOCATIONSCB Rückruffunktion (d3dumddi.h)
Vom Anzeigetreiber für den Benutzermodus aufgerufen, um Videospeicherzuweisungen 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-Laufzeit hat den Benutzermodustreiber übergeben, der dieses Handle als hDevice- Mitglied der D3DDDIARG_CREATEDEVICE-Struktur bei der Geräteerstellung verwendet.
unnamedParam2
pData- [in]
Ein Zeiger auf eine D3DDDICB_OFFERALLOCATIONS-Struktur, die die vom Treiber angebotenen Videospeicherzuweisungen definiert.
Rückgabewert
Gibt einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Zuteilungen wurden erfolgreich angeboten. Hinweis: Wenn der Treiber nicht pfnOfferAllocationsCbaufrufen muss, sollte er S_OK zurückgeben. |
| D3DDDIERR_DEVICEREMOVED | Der Videospeicher-Manager oder der Anzeige-Miniporttreiber konnte den Vorgang nicht abschließen, da entweder ein Plug and Play -Ereignis (PnP) Stop-Ereignis oder ein Timeout Detection and Recovery (TDR)-Ereignis 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-Laufzeit zurückgeben. |
| E_INVALIDARG | Es wurde ein ungültiger Parameter angegeben. |
Bemerkungen
Der Benutzermodus-Anzeigetreiber ruft pfnOfferAllocationsCb- auf, um das Microsoft DirectX-Grafik-Kernel-Subsystem zu benachrichtigen, dass es nach Abschluss aller zuvor übermittelten Rendervorgänge den Speicher der Zuordnungen für andere zu verwendende Prozesse bieten kann.
Nachdem der Treiber pfnOfferAllocationsCb- aufgerufen hat, um eine Wiederverwendungszuweisung anzubieten, muss er pfnReclaimAllocationsCb aufrufen, bevor die Zuordnung gesperrt oder für Renderingvorgänge übermittelt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |