Método IStillImageW::EnableHwNotifications (sti.h)
O método IStillImage::EnableHwNotifications solicita que o monitor de eventos de imagem ainda habilite ou desabilite a notificação de aplicativos quando eventos de dispositivo still image ocorrerem para um dispositivo especificado.
Sintaxe
HRESULT EnableHwNotifications(
[in] LPCWSTR pwszDeviceName,
BOOL bNewState
);
Parâmetros
[in] pwszDeviceName
Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa um nome de dispositivo interno, obtido chamando IStillImage::GetSTILaunchInformation ou IStillImage::GetDeviceList.
bNewState
Valor fornecido pelo chamador, defina como TRUE para habilitar notificações e FALSE para desabilitá-las.
Retornar valor
Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.
Comentários
O método IStillImage::EnableHwNotifications habilita ou desabilita notificações de eventos de dispositivo de imagem parada para todos os aplicativos, não apenas para o aplicativo de chamada. As notificações de evento são habilitadas por padrão. Esse método destina-se ao uso por aplicativos que interceptam eventos de dispositivos e os redirecionam.
Antes de chamar IStillImage::EnableHwNotifications, os clientes da interface COM IStillImage devem chamar IStillImage::StiCreateInstance para obter um ponteiro de interface IStillImage .
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Área de Trabalho |
Cabeçalho | sti.h (inclua Sti.h) |