CreateICA, fonction (wingdi.h)

Article
03/06/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, Epson).

[in] pszDevice

Pointeur vers une chaîne de caractères terminée par null qui spécifie le nom du périphérique de sortie spécifique utilisé, comme indiqué par le Gestionnaire d’impression (par exemple, Epson 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. Il est fourni 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 avoir la valeur 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 retournée

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

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

Notes

L’en-tête wingdi.h définit CreateIC comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll