PDD_DESTROYDDLOCAL funzione di callback (ddrawint.h)
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 .
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | ddrawint.h (include Winddi.h) |