Compartilhar via

Método IMFCameraControlMonitor::RemoveControlSubscription (mfidl.h)

  • Artigo

Remove um controle de câmera da lista de controles para os quais as notificações IMFCameraControlNotify::OnChange serão geradas.

Sintaxe

HRESULT RemoveControlSubscription(
  GUID   controlSet,
  UINT32 id
);

Parâmetros

controlSet

O GUID para o conjunto de controle de câmera ao qual o controle adicionado pertence.

id

A ID do controle dentro do conjunto de controle.

Retornar valor

Um HRESULT incluindo o seguinte:

Valor Descrição
S_OK Êxito
MF_E_INVALIDREQUEST O monitor de controle da câmera está no estado de execução ou desligamento.
MF_E_INVALIDARG Um valor inválido foi fornecido para controlSet. Confira Comentários para obter mais informações.
MF_E_NOT_FOUND Nenhuma assinatura foi encontrada para o controle especificado.

Comentários

Tentar adicionar ou remover assinaturas depois de chamar Iniciar , mas antes de chamar Parar ou depois de chamar Desligamento, resultará em um erro.

Os controles explicitamente compatíveis incluem as propriedades em PROPSETID_VIDCAP_VIDEOPROCAMP e PROPSETID_VIDCAP_CAMERACONTROL e KSPROPERTYSETID_ExtendedCameraControl. Se AddControlSubscription for chamado com KSPROPERTYSETID_ANYCAMERACONTROL como o parâmetro controlSet , a assinatura criada provocará retornos de chamada para qualquer alteração de controle, mesmo aqueles fora dos conjuntos de propriedades listados anteriormente.

Especificar um valor diferente de KSPROPERTYSETID_ANYCAMERACONTROL, PROPSETID_VIDCAP_VIDEOPROCAMP, PROPSETID_VIDCAP_CAMERACONTROL ou KSPROPERTYSETID_ExtendedCameraControl resultará em um erro.

Para ver um exemplo de código que implementa esse método, consulte IMFCameraControlNotify.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11 Build 22621
Servidor mínimo com suporte Windows 11 Build 22621
Cabeçalho mfidl.h
Biblioteca mfsensorgroup.lib
DLL mfsensorgroup.dll