Método ICaptureGraphBuilder2::FindPin (strmif.h)

[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 FindPin método recupera um determinado pino em um filtro ou determina se um determinado pino corresponde aos critérios especificados.

Sintaxe

HRESULT FindPin(
  [in]  IUnknown      *pSource,
  [in]  PIN_DIRECTION pindir,
  [in]  const GUID    *pCategory,
  [in]  const GUID    *pType,
  [in]  BOOL          fUnconnected,
  [in]  int           num,
  [out] IPin          **ppPin
);

Parâmetros

[in] pSource

Ponteiro para uma interface em um filtro ou para uma interface em um pino.

[in] pindir

Membro da enumeração PIN_DIRECTION que especifica a direção do pino (entrada ou saída).

[in] pCategory

Um ponteiro para um GUID que especifica uma das categorias de pino listadas no Conjunto de Propriedades do Pin. Para corresponder a qualquer pino, independentemente da categoria, defina esse parâmetro como NULL.

[in] pType

Ponteiro para um GUID de tipo principal que especifica o tipo de mídia. Use NULL para corresponder a qualquer tipo de mídia.

[in] fUnconnected

Valor booliano que especifica se o pino deve ser desconectado. Se TRUE, o pino deverá ser desconectado. Se FALSE, o pino poderá ser conectado ou desconectado.

[in] num

Índice baseado em zero do pino a ser recuperado do conjunto de pinos correspondentes. Se pSource for um ponteiro para um filtro e mais de um pino corresponder aos critérios de pesquisa, esse parâmetro especificará qual pino recuperar. Se pSource for um ponteiro para um pin, esse parâmetro será ignorado.

[out] ppPin

Endereço de um ponteiro para receber a interface IPin do pino correspondente.

Retornar valor

Retorna S_OK se um pino correspondente for encontrado ou E_FAIL caso contrário.

Comentários

Se pSource for um ponteiro para um filtro, o método pesquisará o nth pin nesse filtro que corresponde aos critérios de pesquisa, em que n é fornecido pelo parâmetro num . Se o método encontrar um pino correspondente, ele retornará um ponteiro para o pino no parâmetro ppPin .

Se pSource for um ponteiro para um pin, o método testará esse marcador nos critérios de pesquisa. Se o pino corresponder aos critérios, o método retornará S_OK e retornará um ponteiro para a interface IPin do pino no parâmetro ppPin . Caso contrário, ele retornará E_FAIL.

Em ambos os casos, se o método for bem-sucedido, a interface IPin retornada no parâmetro ppPin terá uma contagem de referência pendente. Certifique-se de liberar a interface quando terminar de usá-la.

Normalmente, um aplicativo não precisará usar esse método. Ele é fornecido para tarefas extraordinariamente complexas, quando o método ICaptureGraphBuilder2::RenderStream não pode criar o grafo de filtro. Use esse método para recuperar um pino desejado de um filtro de captura e, em seguida, compile o restante do grafo manualmente.

Requisitos

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

ICaptureGraphBuilder2 Interface