PDD_DESTROYDDLOCAL Rückruffunktion (ddrawint.h)
Die D3dDestroyDLocal-Funktion zerstört alle Microsoft Direct3D-Oberflächen, die zuvor von der D3dCreateSurfaceEx-Funktion erstellt wurden und zu demselben angegebenen lokalen Microsoft DirectDraw-Objekt gehören.
Syntax
PDD_DESTROYDDLOCAL PddDestroyddlocal;
DWORD PddDestroyddlocal(
PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}
Parameter
unnamedParam1
Verweist auf eine DDHAL_DESTROYDDLOCALDATA-Struktur , die die Informationen enthält, die der Treiber zum Zerstören der Oberflächen benötigt.
Rückgabewert
D3dDestroyDLocal gibt einen der folgenden Rückrufcodes zurück:
Hinweise
Alle Direct3D-Treiber müssen D3dDestroyDLocal unterstützen.
Direct3D ruft D3dDestroyDLocal auf, wenn die Anwendung angibt, dass der Direct3D-Kontext nicht mehr erforderlich ist und er zusammen mit allen zugeordneten Oberflächen zerstört wird. Die Zuordnung erfolgt über den Zeiger auf das lokale DirectDraw-Objekt. Der Treiber muss bei Bedarf arbeitsspeicherfrei geben, den der D3dCreateSurfaceEx-Rückruf des Treibers für jede Oberfläche zugeordnet hat.
Der Treiber sollte die DirectDraw-Oberflächen, die diesen Direct3D-Oberflächen zugeordnet sind, nicht zerstören. Dies liegt in der Verantwortung der Anwendung.
Der Zeiger auf die DD_DIRECTDRAW_LOCAL-Struktur , die als lpDDLcl-Member der D3DHAL_CONTEXTCREATEDATA-Struktur übergeben wurde, als D3dContextCreate aufgerufen wurde, wird vom Betriebssystem freigegeben, nachdem D3dDestroyDDLocal zurückgegeben wurde.
D3dDestroyDLocal kann mit einem deaktivierten PDEV aufgerufen werden. Ein PDEV wird durch Aufrufen der DrvAssertMode-Funktion des Anzeigetreibers deaktiviert oder aktiviert. Weitere Informationen finden Sie unter Verwalten von PDEVs .
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ddrawint.h (einschließlich Winddi.h) |