Compartilhar via


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)