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)

Confira também

IStillImage::LaunchApplicationForDevice

IStillImageW