PFND3DDDI_DEALLOCATE2CB Rückruffunktion (d3dumddi.h)
Die pfnDeallocate2Cb Benutzermodusrückruffunktion gibt Zuordnungen für ein Kernelmodusressourcenobjekt frei, wenn das Ressourcenobjekt erstellt wurde.
pfnDeallocate2Cb ist ein Ersatz für pfnDeallocateCb mit einem zusätzlichen Flags Mitglied. Wenn Flags auf alle Nullen festgelegt sind, entspricht das Verhalten pfnDeallocateCb.
Syntax
PFND3DDDI_DEALLOCATE2CB Pfnd3dddiDeallocate2cb;
HRESULT Pfnd3dddiDeallocate2cb(
HANDLE hDevice,
const D3DDDICB_DEALLOCATE2 *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData- [in]
Ein Zeiger auf eine D3DDDICB_DEALLOCATE2 Struktur, die die freizugebende Ressource beschreibt.
Rückgabewert
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der Speicher wurde erfolgreich freigegeben. |
| E_INVALIDARG | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
Diese Funktion kann auch andere HRESULT-Werte zurückgeben.
Bemerkungen
Wenn eine Zuordnungsvernichtungsanforderung empfangen wird, geht VidMm standardmäßig davon aus, dass Befehle, die vor der Vernichtungsanforderung in die Warteschlange gestellt wurden, auf die zu zerstörende Zuordnung zugreifen und den Vernichtungsvorgang zurückstellen, bis die in die Warteschlange eingereihten Befehle abgeschlossen sind. Wenn der Benutzermodustreiber (UMD) weiß, dass ausstehende Befehle nicht auf die zu zerstörende Zuordnung zugreifen, kann VidMm angewiesen werden, nicht zu warten, bis ausstehende Befehle beendet sind, indem die AssumeNotInUse Flag auf TRUE beim Aufrufen von pfnDeallocate2Cbfestgelegt wird.
Wenn eine Anwendung oder UMD sicherstellen möchte, dass der Zuordnungsspeicher vor der Rückgabe des pfnDeallocate2Cb- Aufrufs erneut beansprucht wird (z. B. um spitzen Speicherauslastung zu minimieren, wenn die Oberfläche neu erstellt wird), sollte die SynchronDestroy Flag festgelegt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |