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) |