Funzione DdGetDC (ddrawgdi.h)
[Questa funzione è soggetta a modifiche con ogni revisione del sistema operativo. Usare invece DirectDraw e Microsoft Direct3DAPIs; queste API isolano le applicazioni da tali modifiche al sistema operativo e nascondono molte altre difficoltà coinvolte nell'interagire direttamente con i driver di visualizzazione.
Wrapper per la funzione NtGdiDdGetDC e restituisce un contesto del dispositivo Windows Graphics Device Interface (GDI) che rappresenta l'area Microsoft DirectDraw indicata.
GdiEntry7 è definito come alias per questa funzione.
Sintassi
HDC DdGetDC(
LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
LPPALETTEENTRY pColorTable
);
Parametri
pSurfaceLocal
Puntatore alla superficie DirectDraw per cui viene richiesto un controller di dominio.
pColorTable
Puntatore facoltativo a una matrice di 256 voci di strutture PALETTEENTRY . Se la tabella dei colori è Null e la modalità di visualizzazione e superficie sono entrambi 8 bit per pixel, il controller di dominio condivide la tabella colori del dispositivo.
Valore restituito
Se ha esito positivo, questa funzione restituisce un HDC valido; in caso contrario, restituisce NULL.
Commenti
Se sia la superficie che la modalità di visualizzazione corrente vengono palletizzate a 8 bit per pixel, il controller di dominio può essere dato la proprietà speciale condivisa dalla tabella colori del dispositivo visualizzato. Le applicazioni sono consigliate per chiamare IDirectDrawSurface7::GetDC , che fornisce la stessa funzionalità in modo indipendente dal sistema operativo.
Il controller di dominio restituito deve essere liberato da una chiamata a NtGdiDdReleaseDC o GdiEntry8.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ddrawgdi.h |