Funzione NtGdiDdGetDC

[Questa funzione è soggetta a modifiche con ogni revisione del sistema operativo. Usare invece Microsoft DirectDraw e Microsoft Direct3DAPIs; queste API isolano le applicazioni da tali modifiche al sistema operativo e nascondono molte altre difficoltà nell'interagire direttamente con i driver di visualizzazione.

Crea un contesto di dispositivo (DC) per la superficie specificata.

Sintassi

HDC APIENTRY NtGdiDdGetDC(
  _In_ HANDLE       hSurface,
  _In_ PALETTEENTRY *puColorTable
);

Parametri

hSurface [in]

Gestire in una superficie DirectDraw in modalità kernel restituita in precedenza da NtGdiDdCreateSurface o NtGdiDdCreateSurfaceObject.

puColorTable [in]

Puntatore a una tabella dei colori di override per il controller di dominio restituito.

Valore restituito

In caso di esito positivo, questa funzione restituisce un HDC valido; in caso contrario restituisce NULL.

Commenti

È consentito un solo controller di dominio per superficie in qualsiasi momento. Le chiamate successive a NtGdiDdGetDC avranno esito negativo fino al rilascio del controller di dominio precedente.

È consigliabile chiamare invece IDirectDrawSurface7::GetDC , che fornisce la stessa funzionalità in modo indipendente dal sistema operativo.

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Ntgdi.h

Vedi anche

Supporto client grafica di basso livello

DdGetDC