Função CreateICA (wingdi.h)

Artigo
11/20/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 contexto de dispositivo (DC). 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 deve ser NULL se o driver do dispositivo deve usar a inicialização padrão (se houver) especificada pelo usuário.

Valor de retorno

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.

Observações

Quando você não precisar mais das informações dc, chame a função DeleteDC.

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

DEVMODE

DeleteDC

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

DocumentProperties

getDeviceCaps

Compartilhar via