PDD_DESTROYDDLOCAL Rückruffunktion (ddrawint.h)

Artikel
02/29/2024

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 .