Funzione CreateCompatibleDC (wingdi.h)

Articolo
03/13/2024

La funzione CreateCompatibleDC crea un contesto del dispositivo di memoria compatibile con il dispositivo specificato.

Sintassi

HDC CreateCompatibleDC(
  [in] HDC hdc
);

Parametri

[in] hdc

Handle a un controller di dominio esistente. Se questo handle è NULL, la funzione crea un controller di dominio di memoria compatibile con la schermata corrente dell'applicazione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'handle di un controller di dominio di memoria.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Un controller di dominio di memoria esiste solo in memoria. Quando viene creato il controller di dominio di memoria, la superficie di visualizzazione è esattamente un pixel monocromatico wide e un pixel monocromatico alto. Prima che un'applicazione possa usare un controller di dominio di memoria per le operazioni di disegno, deve selezionare una bitmap della larghezza e dell'altezza corrette nel controller di dominio. Per selezionare una bitmap in un controller di dominio, usare la funzione CreateCompatibleBitmap , specificando l'altezza, la larghezza e l'organizzazione del colore necessarie.

Quando viene creato un controller di dominio di memoria, tutti gli attributi vengono impostati su valori predefiniti normali. Il controller di dominio di memoria può essere usato come controller di dominio normale. È possibile impostare gli attributi; ottenere le impostazioni correnti dei relativi attributi; e selezionare penne, pennelli e aree.

La funzione CreateCompatibleDC può essere usata solo con i dispositivi che supportano le operazioni raster. Un'applicazione può determinare se un dispositivo supporta queste operazioni chiamando la funzione GetDeviceCaps .

Quando non è più necessario il controller di dominio di memoria, chiamare la funzione DeleteDC . È consigliabile chiamare DeleteDC per eliminare il controller di dominio. Tuttavia, è anche possibile chiamare DeleteObject con HDC per eliminare il controller di dominio.

Se hdc è NULL, il thread che chiama CreateCompatibleDC possiede l'HDC creato. Quando questo thread viene distrutto, HDC non è più valido. Pertanto, se si crea HDC e lo si passa a un altro thread, uscire dal primo thread, il secondo thread non sarà in grado di usare HDC.

ICM: Se il controller di dominio passato a questa funzione è abilitato per Image Color Management (ICM), il controller di dominio creato dalla funzione è abilitato per ICM. Gli spazi di colore di origine e di destinazione vengono specificati nel controller di dominio.

Esempio

Per un esempio, vedere Acquisizione di un'immagine.

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	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll