Partilhar via


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 de imagem ainda ocorrer 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, definido como VERDADEIRO para habilitar notificações e FALSE para desabilitá-las.

Valor de retorno

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.

Observações

O método IStillImage::EnableHwNotifications habilita ou desabilita notificações de eventos de dispositivo de imagem ainda 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
da Plataforma de Destino Área de trabalho
cabeçalho sti.h (inclua Sti.h)

Consulte também

IStillImage::LaunchApplicationForDevice

IStillImageW