Interfaz IAsyncReader (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

La IAsyncReader interfaz realiza una solicitud de datos asincrónica en un filtro.

Esta interfaz se expone mediante patillas de salida que realizan operaciones de lectura asincrónicas. La interfaz la usa el pin de entrada en el filtro de bajada. Las aplicaciones no usan esta interfaz. El filtro De origen de archivo asincrónico expone esta interfaz en su pin de salida.

Desarrolladores de filtros: implemente esta interfaz si el pin de salida entrega datos en forma de flujo de bytes (MEDIATYPE_Stream) y admite el modelo de extracción. Durante el proceso de conexión, compruebe si las consultas de patillas descendentes de la IAsyncReader interfaz. Si no es así, el pin debe producir un error en la conexión o establecer otro transporte. (Si el pin deriva de CBasePin, realice esta comprobación en el método CBasePin::CheckConnect ).

Para obtener más información sobre el uso de esta interfaz, vea los temas siguientes:

• Negociación de asignadores
• Data Flow para desarrolladores de filtros
• CPullPin (clase)

Herencia

La interfaz IAsyncReader hereda de la interfaz IUnknown . IAsyncReader también tiene estos tipos de miembros:

Métodos

La interfaz IAsyncReader tiene estos métodos.

IAsyncReader::BeginFlush El método BeginFlush inicia una operación de vaciado. (IAsyncReader.BeginFlush)
IAsyncReader::EndFlush El método EndFlush finaliza una operación de vaciado. (IAsyncReader.EndFlush)
IAsyncReader::Length El método Length recupera la longitud total de la secuencia.
IAsyncReader::Request El método Request pone en cola una solicitud asincrónica para los datos.
IAsyncReader::RequestAllocator El método RequestAllocator solicita un asignador durante la conexión de patillas.
IAsyncReader::SyncRead El método SyncRead realiza una lectura sincrónica. El método se bloquea hasta que se completa la solicitud. Las posiciones de archivo y la dirección del búfer no tienen que alinearse. Si la solicitud no está alineada, el método realiza una operación de lectura almacenada en búfer.
IAsyncReader::SyncReadAligned El método SyncReadAligned realiza una lectura sincrónica. El método se bloquea hasta que se completa la solicitud. Las posiciones de archivo y la dirección del búfer deben alinearse; compruebe las propiedades del asignador para la alineación necesaria.
IAsyncReader::WaitForNext El método WaitForNext espera a que se complete la siguiente solicitud de lectura pendiente.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)