PFND3DDDI_OFFERALLOCATIONS2CB Rückruffunktion (d3dumddi.h)
Vom Anzeigetreiber für den Benutzermodus aufgerufen, um Videospeicherzuweisungen 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-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_OFFERALLOCATIONS2 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 pfnOfferAllocations2Cb- aufrufen 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 pfnOfferAllocations2Cb- 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 pfnOfferAllocations2Cb- aufgerufen hat, um eine Wiederverwendungszuweisung anzubieten, muss er pfnReclaimAllocations3Cb- aufrufen, bevor die Zuordnung gesperrt oder für Renderingvorgänge übermittelt wird.
pfnOfferAllocations2Cb funktionen identisch mit pfnOfferAllocationsCb, außer dass sie Flags über den pData-Parameter berücksichtigt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Fenster |
| Header- | d3dumddi.h (include D3dumddi.h) |