Método IStillImageW::EnableHwNotifications (sti.h)
El método IStillImage::EnableHwNotifications solicita al monitor de eventos still image que habilite o deshabilite la notificación de las aplicaciones cuando se produzcan eventos de dispositivo still image para un dispositivo especificado.
Sintaxis
HRESULT EnableHwNotifications(
[in] LPCWSTR pwszDeviceName,
BOOL bNewState
);
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.
bNewState
Valor proporcionado por el autor de la llamada, establecido en TRUE para habilitar las notificaciones y FALSE para deshabilitarlas.
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::EnableHwNotifications habilita o deshabilita las notificaciones de eventos de dispositivo de imagen fija para todas las aplicaciones, no solo para la aplicación que realiza la llamada. Las notificaciones de eventos están habilitadas de forma predeterminada. Este método está diseñado para su uso por las aplicaciones que interceptan eventos de dispositivos y los vuelven a enrutar.
Antes de llamar a IStillImage::EnableHwNotifications, los clientes de la interfaz COM IStillImage deben llamar a IStillImage::StiCreateInstance para obtener un puntero de interfaz IStillImage .
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | sti.h (include Sti.h) |