Método IStillImageW::CreateDevice (sti.h)

El método IStillImage::CreateDevice crea una instancia del objeto COM que define la interfaz COM IStiDevice y devuelve un puntero a la interfaz.

Sintaxis

HRESULT CreateDevice(
  [in]           LPWSTR     pwszDeviceName,
                 DWORD      dwMode,
  [out]          PSTIDEVICE *pDevice,
  [in, optional] LPUNKNOWN  punkOuter
);

Parámetros

[in] pwszDeviceName

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

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.

[out] pDevice

Recibe un puntero a la interfaz COM de IStiDevice.

[in, optional] punkOuter

Opcional, puntero proporcionado por el autor de la llamada al "control desconocido" para la agregación de objetos. Consulte la sección Comentarios siguiente.

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

Para que una aplicación use la interfaz IStiDevice , primero debe llamar a IStillImage::StiCreateInstance para obtener un puntero a la interfaz IStillImage y, a continuación, llamar a IStillImage::CreateDevice para obtener un puntero a la interfaz IStiDevice . El puntero recibido en pDevice se usa posteriormente al llamar a métodos IStiDevice , como se muestra en el código de imagen de la imagen de ejemplo, para obtener acceso al dispositivo especificado.

Si desea crear un objeto COM agregado que incluya IStiDevice, debe proporcionar un puntero al "control desconocido" en punkOuter. En la mayoría de los casos, no va a crear un objeto agregado, por lo que punkOuter debe ser NULL. La agregación de objetos y el control desconocido se describen en la documentación de Microsoft Windows SDK y en la Especificación del modelo de objetos componentes.

Requisitos

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

Consulte también

IStiDevice::Release

IStillImageW