Compartilhar via

Método IStiDevice::Initialize (sti.h)

  • Artigo

Este método destina-se apenas ao uso interno.

O método IStiDevice::Initialize inicializa uma instância do objeto COM que define a interface IStiDevice .

Sintaxe

HRESULT Initialize(
  [in] HINSTANCE hinst,
  [in] LPCWSTR   pwszDeviceName,
       DWORD     dwVersion,
       DWORD     dwMode
);

Parâmetros

[in] hinst

Identificador de instância fornecido pelo chamador do processo de chamada. Esse identificador é obtido chamando GetModuleName(NULL).

[in] pwszDeviceName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa um nome de dispositivo interno, obtido chamando IStillImage::GetSTILaunchInformation.

dwVersion

Número de versão de STI fornecido pelo chamador. Esse valor deve ser STI_VERSION, definido em Sti.h.

dwMode

Valor constante fornecido pelo chamador que indica os Modos de Transferência nos quais o dispositivo deve ser usado. Os valores a seguir são válidos.

Mode Descrição
STI_DEVICE_CREATE_BOTH O dispositivo está sendo aberto para obter status e transferir dados.
STI_DEVICE_CREATE_DATA O dispositivo está sendo aberto somente para transferências de dados.
STI_DEVICE_CREATE_STATUS O dispositivo está sendo aberto apenas para obter informações de status.

Retornar valor

Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Comentários

O método IStiDevice::Initialize inicializa a instância de objeto COM que foi criada chamando IStillImage::CreateDevice.

Como IStiDevice::Initialize é chamado por IStillImage::CreateDevice, os clientes da interface IStiDevice normalmente não chamam esse método diretamente.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho sti.h (inclua Sti.h)