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 |