Método IQualityControl::SetSink (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O SetSink método define o objeto IQualityControl que receberá mensagens de qualidade.

Sintaxe

HRESULT SetSink(
  IQualityControl *piqc
);

Parâmetros

piqc

Ponteiro para o objeto IQualityControl para o qual as notificações devem ser enviadas.

Retornar valor

Retorna um valor HRESULT que depende da implementação. HRESULT pode ser uma das seguintes constantes padrão ou outros valores não listados.

Código de retorno Descrição
E_FAIL
 Falha.
E_POINTER
 Argumento de ponteiro NULL.
E_INVALIDARG
 Argumento inválido.
E_NOTIMPL
 Não há suporte para o método .
S_OK ou NOERROR
 Êxito.

Comentários

O filtro que recebe uma chamada para esse método deve registrar o piqc, mas não deve adicionar uma contagem de referência a ele. O objeto apontado será um gerenciador de qualidade e fará parte do grafo de filtro (por exemplo, um distribuidor de plug-in). Adicionar uma contagem de referência a isso pode causar problemas de referência circular.

A referência ao objeto especificado no piqc tem a garantia de ser válida até que esse método seja chamado com um valor nulo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IQualityControl Interface