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

Este método solo se utiliza de forma interna.

El método IStiDevice::Initialize inicializa una instancia del objeto COM que define la interfaz IStiDevice .

Sintaxis

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

Parámetros

[in] hinst

Identificador de instancia proporcionado por el autor de la llamada del proceso de llamada. Este identificador se obtiene llamando a GetModuleName(NULL).

[in] pwszDeviceName

Puntero proporcionado por el autor de la llamada a una cadena que representa un nombre de dispositivo interno, obtenido mediante una llamada a IStillImage::GetSTILaunchInformation.

dwVersion

Número de versión de STI proporcionado por el autor de la llamada. Este valor debe ser STI_VERSION, definido en Sti.h.

dwMode

Valor constante proporcionado por el autor de la llamada que indica los modos de transferencia en los que se va a usar el dispositivo. Los valores siguientes son válidos.

Mode	Descripción
STI_DEVICE_CREATE_BOTH	El dispositivo se está abriendo para obtener el estado y transferir datos.
STI_DEVICE_CREATE_DATA	El dispositivo solo se abre para las transferencias de datos.
STI_DEVICE_CREATE_STATUS	El dispositivo solo se abre para obtener información de estado.

Valor devuelto

Si la operación se realiza correctamente, el método devuelve S_OK. De lo contrario, devuelve uno de los códigos de error con prefijo STIERR definidos en stierr.h.

Comentarios

El método IStiDevice::Initialize inicializa la instancia de objeto COM que se creó llamando a IStillImage::CreateDevice.

Dado que IStiDevice::Initialize lo llama IStillImage::CreateDevice, los clientes de la interfaz IStiDevice no suelen llamar directamente a este método.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	sti.h (include Sti.h)