CreateICA, fonction (wingdi.h)

Article
11/20/2024

La fonction CreateIC crée un contexte d’informations pour l’appareil spécifié. Le contexte d’informations fournit un moyen rapide d’obtenir des informations sur l’appareil sans créer de contexte d’appareil (DC). Toutefois, les fonctions de dessin GDI ne peuvent pas accepter de handle dans un contexte d’information.

Syntaxe

HDC CreateICA(
  [in] LPCSTR         pszDriver,
  [in] LPCSTR         pszDevice,
       LPCSTR         pszPort,
  [in] const DEVMODEA *pdm
);

Paramètres

[in] pszDriver

Pointeur vers une chaîne de caractères terminée par null qui spécifie le nom du pilote de périphérique (par exemple, Merci).

[in] pszDevice

Pointeur vers une chaîne de caractères terminée par null qui spécifie le nom de l’appareil de sortie spécifique utilisé, comme indiqué par le Gestionnaire d’impression (par exemple, Fx FX-80). Il ne s’agit pas du nom du modèle d’imprimante. Le paramètre lpszDevice doit être utilisé.

pszPort

Ce paramètre est ignoré et doit être défini sur NULL. Elle est fournie uniquement pour la compatibilité avec Windows 16 bits.

[in] pdm

Pointeur vers une structure DEVMODE contenant des données d’initialisation spécifiques à l’appareil pour le pilote de périphérique. La fonction DocumentProperties récupère cette structure remplie pour un appareil spécifié. Le paramètre lpdvmInit doit être NULL si le pilote de périphérique doit utiliser l’initialisation par défaut (le cas échéant) spécifiée par l’utilisateur.

Valeur de retour

Si la fonction réussit, la valeur de retour est le handle d’un contexte d’information.

Si la fonction échoue, la valeur de retour est NULL .

Remarques

Quand vous n’avez plus besoin des informations du contrôleur de domaine, appelez la fonction DeleteDC.

Note

L’en-tête wingdi.h définit CreateIC comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wingdi.h (include Windows.h)
bibliothèque	Gdi32.lib
DLL	Gdi32.dll