ICaptureGraphBuilder2::FindPin

9/8/2008

Este método recupera um pino específico em um filtro, ou determina se um pino determinado corresponde aos critérios especificados.

Syntax

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

Parameters

• pSource
  [no] Ponteiro para uma interface em um filtro, ou para uma interface em um pino.

• pindir
  [no] Membro das PIN_DIRECTION enumeração que especifica a direção pino (entrada ou saída).

• pCategory
  [no] Um ponteiro para uma categoria pino a partir de AMPROPERTY_PIN_CATEGORY propriedade definida (consulte Conjunto de propriedades de pino). Usar NULL para coincidir com qualquer categoria.

• pType
  [no] Ponteiro para um principal tipo GUID que especifica a tipo de mídia. Usar NULL para coincidir com qualquer tipo de mídia.

• fUnconnected
  [no] Boolean valor que especifica se o pino deve ser desconectado. Se TRUE, o pino deve ser desconectado. Se FALSE, o pino pode ser conectado ou desconectado.

• Num
  [no] Índice baseado em zero do pino para recuperar, do conjunto de compatível pinos. Se pSource é um ponteiro para um filtro, e mais de um pino correspondências critérios de pesquisa, este parâmetro especifica qual pino para recuperar. Se pSource é um ponteiro para um pino, este parâmetro é ignorado.

• ppPin
  [out] Endereço de um ponteiro para receber o Interface IPin Do compatível pino.

Return Value

Retorna S_OK se um compatível pino for encontrado, ou E_FAIL caso contrário.

Remarks

Se pSource é um ponteiro para um filtro, o procura método o npino TH nesse filtro que correspondam aos critérios de pesquisa, onde n é determinado pela Num parâmetro. Se o método encontrar um compatível pino, ele retorna um ponteiro para o pino in a ppPin parâmetro.

Se pSource é um ponteiro para um pino, o método testes que pino contra critérios de pesquisa. Se o pino corresponde aos critérios, o método Retorna S_OK e retornará um ponteiro para do o pino IPin interface in a ppPin parâmetro. Caso contrário, retornará E_FAIL.

Em ambos os maiúsculas e minúsculas, se o método for bem-sucedido, o IPin interface retornado na ppPin parâmetro tem um pendente contagem de referência. Não se esqueça versão de interface quando você terminar de usá-lo.

Normalmente, um aplicativo não precisará usar esse método. Ele é fornecido para tarefas complexas incomum, quando o ICaptureGraphBuilder2::RenderStream método não é possível compilar o filtro gráfico. Use este método para recuperar um pino desejado de uma filtro de captura e então compilar o resto do gráfico manualmente.

Requirements

Windows Embedded CE	Windows Embedded CE 6.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later
Note	Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment

See Also

Reference

ICaptureGraphBuilder2 Interface
PIN_DIRECTION
IPin Interface
ICaptureGraphBuilder2::RenderStream

Concepts

Pin Property Set