Funzione DdGetDC (ddrawgdi.h)

  • Articolo

[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

Vedi anche

Supporto client a basso livello di grafica