Função CreateICA (wingdi.h)

Artigo
03/04/2024

A função CreateIC cria um contexto de informações para o dispositivo especificado. O contexto de informações fornece uma maneira rápida de obter informações sobre o dispositivo sem criar um DC (contexto de dispositivo). No entanto, as funções de desenho GDI não podem aceitar um identificador para um contexto de informações.

Sintaxe

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

Parâmetros

[in] pszDriver

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do driver do dispositivo (por exemplo, Epson).

[in] pszDevice

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do dispositivo de saída específico que está sendo usado, conforme mostrado pelo Gerenciador de Impressão (por exemplo, Epson FX-80). Não é o nome do modelo de impressora. O parâmetro lpszDevice deve ser usado.

pszPort

Esse parâmetro é ignorado e deve ser definido como NULL. Ele é fornecido apenas para compatibilidade com o Windows de 16 bits.

[in] pdm

Um ponteiro para uma estrutura DEVMODE que contém dados de inicialização específicos do dispositivo para o driver de dispositivo. A função DocumentProperties recupera essa estrutura preenchida para um dispositivo especificado. O parâmetro lpdvmInit deverá ser NULL se o driver do dispositivo for usar a inicialização padrão (se houver) especificada pelo usuário.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o identificador para um contexto de informações.

Se a função falhar, o valor retornado será NULL.

Comentários

Quando você não precisar mais do DC de informações, chame a função DeleteDC .

Observação

O cabeçalho wingdi.h define CreateIC como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll