Interface IPin (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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.]

Essa interface é exposta por todos os pinos de entrada e saída.

O gerenciador de grafo de filtro usa essa interface para conectar pinos e executar operações de liberação. Os aplicativos podem usar essa interface para consultar o pin para obter informações. Os aplicativos nunca devem chamar IPin métodos que alteram o estado de um pin, como Connect, Disconnect, BeginFlush ou EndFlush. Para conectar pinos, um aplicativo deve usar os métodos no IGraphBuilder.

Filtrar desenvolvedores: As classes CBasePin, CBaseInputPin e CBaseOutputPin implementam essa interface. Outras classes base derivam dessas três classes.

Herança

A interface IPin herda da interface IUnknown . O IPin também tem esses tipos de membros:

Métodos

A interface IPin tem esses métodos.

IPin::BeginFlush O método BeginFlush inicia uma operação de liberação. (IPin.BeginFlush)
IPin::Connect O método Connect conecta o pino a outro pino.
IPin::ConnectedTo O método ConnectedTo recupera um ponteiro para o pino conectado, se houver.
IPin::ConnectionMediaType O método ConnectionMediaType recupera o tipo de mídia para a conexão de pino atual, se houver.
IPin::D isconnect O método Disconnect quebra a conexão de pino atual.
IPin::EndFlush O método EndFlush encerra uma operação de liberação. (IPin.EndFlush)
IPin::EndOfStream O método EndOfStream notifica o pino de que nenhum dado adicional é esperado, até que um novo comando de execução seja emitido para o filtro.
IPin::EnumMediaTypes O método EnumMediaTypes enumera os tipos de mídia preferenciais do pino.
IPin::NewSegment O método NewSegment notifica o pino que os exemplos de mídia recebidos após essa chamada são agrupados como um segmento, com uma hora de início comum, hora de parada e taxa.
IPin::QueryAccept O método QueryAccept determina se o pin aceita um tipo de mídia especificado.
IPin::QueryDirection O método QueryDirection obtém a direção do pino (entrada ou saída).
IPin::QueryId O método QueryId recupera um identificador para o pino.
IPin::QueryInternalConnections O método QueryInternalConnections recupera os pinos conectados internamente a esse pino (dentro do filtro).
IPin::QueryPinInfo O método QueryPinInfo recupera informações sobre o pino.
IPin::ReceiveConnection O método ReceiveConnection aceita uma conexão de outro pin.

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)