PDD_DESTROYDDLOCAL funzione di callback (ddrawint.h)

Articolo
08/23/2023

La funzione D3dDestroyDDLocal elimina tutte le superfici Microsoft Direct3D create in precedenza dalla funzione D3dCreateSurfaceEx che appartengono allo stesso oggetto Microsoft DirectDraw locale specificato.

Sintassi

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

Parametri

unnamedParam1

Punta a una struttura DDHAL_DESTROYDDLOCALDATA che contiene le informazioni necessarie per eliminare definitivamente le superfici da parte del conducente.

Valore restituito

D3dDestroyDDLocal restituisce uno dei codici di callback seguenti:

Commenti

Tutti i driver Direct3D devono supportare D3dDestroyDDLocal.

Direct3D chiama D3dDestroyDDLocal quando l'applicazione indica che il contesto Direct3D non è più necessario e verrà eliminato definitivamente insieme a tutte le superfici associate. L'associazione passa attraverso il puntatore all'oggetto DirectDraw locale. Il driver deve liberare qualsiasi memoria allocata dal callback D3dCreateSurfaceEx del driver per ogni superficie, se necessario.

Il driver non deve distruggere le superfici DirectDraw associate a queste superfici Direct3D. Questa è la responsabilità dell'applicazione.

Puntatore alla struttura DD_DIRECTDRAW_LOCAL passata come membro lpDDLcl della struttura D3DHAL_CONTEXTCREATEDATA quando È stato chiamato D3dContextCreate viene rilasciato dal sistema operativo dopo la restituzione di D3dDestroyDDLocal .

D3dDestroyDDLocal può essere chiamato con un PDEV disabilitato. Un PDEV è disabilitato o abilitato chiamando la funzione DrvAssertMode del driver di visualizzazione. Per altre informazioni, vedere Gestione di PDEV .