Interface IAsyncReader (strmif.h)

  • Artigo

[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.]

A IAsyncReader interface executa uma solicitação de dados assíncrona em um filtro.

Essa interface é exposta por pinos de saída que executam operações de leitura assíncronas. A interface é usada pelo pino de entrada no filtro downstream. Os aplicativos não usam essa interface. O filtro Origem do Arquivo Assíncrono expõe essa interface em seu pino de saída.

Filtrar desenvolvedores: implemente essa interface se o pin de saída fornecer dados na forma de um fluxo de bytes (MEDIATYPE_Stream) e oferecer suporte ao modelo de pull. Durante o processo de conexão, marcar se o pin downstream consulta a IAsyncReader interface. Se isso não acontecer, o pino deverá falhar na conexão ou estabelecer algum outro transporte. (Se o pin derivar de CBasePin, execute esta marcar no método CBasePin::CheckConnect.)

Para obter mais informações sobre como usar essa interface, consulte os seguintes tópicos:

Herança

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

Métodos

A interface IAsyncReader tem esses métodos.

 
IAsyncReader::BeginFlush

O método BeginFlush inicia uma operação de liberação. (IAsyncReader.BeginFlush)
IAsyncReader::EndFlush

O método EndFlush encerra uma operação de liberação. (IAsyncReader.EndFlush)
IAsyncReader::Length

O método Length recupera o comprimento total do fluxo.
IAsyncReader::Request

O método Request enfileira uma solicitação assíncrona de dados.
IAsyncReader::RequestAllocator

O método RequestAllocator solicita um alocador durante a conexão de pino.
IAsyncReader::SyncRead

O método SyncRead executa uma leitura síncrona. O método é bloqueado até que a solicitação seja concluída. As posições do arquivo e o endereço do buffer não precisam ser alinhados. Se a solicitação não estiver alinhada, o método executará uma operação de leitura em buffer.
IAsyncReader::SyncReadAligned

O método SyncReadAligned executa uma leitura síncrona. O método é bloqueado até que a solicitação seja concluída. As posições do arquivo e o endereço do buffer devem ser alinhados; marcar as propriedades do alocador para o alinhamento necessário.
IAsyncReader::WaitForNext

O método WaitForNext aguarda a conclusão da próxima solicitação de leitura pendente.

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)