Interfaccia IAsyncReader (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'interfaccia IAsyncReader esegue una richiesta di dati asincrona in un filtro.

Questa interfaccia viene esposta dai pin di output che eseguono operazioni di lettura asincrone. L'interfaccia viene usata dal pin di input nel filtro downstream. Le applicazioni non usano questa interfaccia. Il filtro Origine file asincrona espone questa interfaccia sul pin di output.

Filtrare gli sviluppatori: implementare questa interfaccia se il pin di output fornisce dati sotto forma di flusso di byte (MEDIATYPE_Stream) e supporta il modello pull. Durante il processo di connessione verificare se le query di pin downstream per l'interfaccia IAsyncReader . In caso contrario, il pin deve non riuscire la connessione o stabilire un altro trasporto. Se il pin deriva da CBasePin, eseguire questo controllo nel metodo CBasePin::CheckConnect .

Per altre informazioni sull'uso di questa interfaccia, vedere gli argomenti seguenti:

Ereditarietà

L'interfaccia IAsyncReader eredita dall'interfaccia IUnknown . IAsyncReader include anche questi tipi di membri:

Metodi

L'interfaccia IAsyncReader include questi metodi.

 
IAsyncReader::BeginFlush

Il metodo BeginFlush inizia un'operazione di scaricamento. (IAsyncReader.BeginFlush)
IAsyncReader::EndFlush

Il metodo EndFlush termina un'operazione di scaricamento. (IAsyncReader.EndFlush)
IAsyncReader::Length

Il metodo Length recupera la lunghezza totale del flusso.
IAsyncReader::Request

Il metodo Request accoda una richiesta asincrona per i dati.
IAsyncReader::RequestAllocator

Il metodo RequestAllocator richiede un allocatore durante la connessione pin.
IAsyncReader::SyncRead

Il metodo SyncRead esegue una lettura sincrona. Il metodo blocca fino al completamento della richiesta. Le posizioni del file e l'indirizzo del buffer non devono essere allineati. Se la richiesta non è allineata, il metodo esegue un'operazione di lettura con buffer.
IAsyncReader::SyncReadAligned

Il metodo SyncReadAligned esegue una lettura sincrona. Il metodo blocca fino al completamento della richiesta. Le posizioni del file e l'indirizzo del buffer devono essere allineati; controllare le proprietà dell'allocatore per l'allineamento richiesto.
IAsyncReader::WaitForNext

Il metodo WaitForNext attende il completamento della successiva richiesta di lettura in sospeso.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)