PFND3DDDI_DEALLOCATE2CB Rückruffunktion (d3dumddi.h)
Die Benutzermodus-Rückruffunktion pfnDeallocate2Cb gibt Zuordnungen für ein Kernelmodusressourcenobjekt frei, wenn das Ressourcenobjekt erstellt wurde.
pfnDeallocate2Cb ist ein Ersatz für pfnDeallocateCb mit einem zusätzlichen Flags-Member . 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 | Die Parameter wurden überprüft und als falsch ermittelt. |
Diese Funktion gibt möglicherweise auch andere HRESULT-Werte zurück.
Hinweise
Wenn eine Zuordnungsvernichtungsanforderung empfangen wird, geht VidMm standardmäßig davon aus, dass Befehle, die vor der Vernichtungsanforderung in die Warteschlange gestellt werden, auf die zu zerstörende Zuordnung zugreifen und den Zerstörungsvorgang zurückstellen können, bis die Befehle in der Warteschlange abgeschlossen sind. Wenn der Benutzermodustreiber (UMD) weiß, dass ausstehende Befehle nicht auf die zerstörte Zuordnung zugreifen, kann er VidMm anweisen, nicht zu warten, bis ausstehende Befehle abgeschlossen sind, indem das Flag AssumeNotInUse beim Aufruf von pfnDeallocate2Cb auf TRUE festgelegt wird.
Wenn eine Anwendung oder UMD sicherstellen möchte, dass der Zuordnungsspeicher vor der Rückgabe des pfnDeallocate2Cb-Aufrufs wieder freigegeben wird (z. B. um die Spitzenauslastung des Arbeitsspeichers zu minimieren, wenn die Oberfläche neu erstellt wird), sollte sie das Flag SynchronousDestroy festlegen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |