Método IStillImageW::GetDeviceInfo (sti.h)
El método IStillImage::GetDeviceInfo devuelve características de hardware para un dispositivo de imagen fija especificado.
Sintaxis
HRESULT GetDeviceInfo(
[in] LPWSTR pwszDeviceName,
[out] LPVOID *ppBuffer
);
Parámetros
[in] pwszDeviceName
Puntero proporcionado por el llamador a una cadena que representa un nombre de dispositivo interno, obtenido llamando a IStillImage::GetSTILaunchInformation o IStillImage::GetDeviceList.
[out] ppBuffer
Recibe un identificador de una estructura de STI_DEVICE_INFORMATION .
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 IStillImage::GetDeviceInfo devuelve una estructura de STI_DEVICE_INFORMATION para el dispositivo de imagen fija especificado. El contenido de la estructura se usa normalmente para crear pantallas de interfaz de usuario.
Antes de llamar a IStillImage::GetDeviceInfo, los clientes de la interfaz COM IStillImage deben llamar a IStillImage::StiCreateInstance para obtener un puntero de interfaz IStillImage .
Cuando el autor de la llamada haya terminado de usar la estructura STI_DEVICE_INFORMATION a la que hace referencia ppBuffer, debe desasignar el búfer llamando a LocalFree (descrito en la documentación de Microsoft Windows SDK).
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | sti.h (include Sti.h) |