Metodo IMFByteStream::BeginRead (mfobjects.h)

Avvia un'operazione di lettura asincrona dal flusso.

Sintassi

HRESULT BeginRead(
  [in] BYTE             *pb,
  [in] ULONG            cb,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parametri

[in] pb

Puntatore a un buffer che riceve i dati. Il chiamante deve allocare il buffer.

[in] cb

Dimensione del buffer in byte.

[in] pCallback

Puntatore all'interfaccia IMFAsyncCallback di un oggetto callback. Il chiamante deve implementare questa interfaccia.

[in] punkState

Puntatore all'interfaccia IUnknown di un oggetto di stato, definito dal chiamante. Questo parametro può essere NULL. È possibile utilizzare questo oggetto per contenere le informazioni sullo stato. L'oggetto viene restituito al chiamante quando viene richiamato il callback.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Quando tutti i dati sono stati letti nel buffer, viene chiamato il metodo IMFAsyncCallback::Invoke dell'oggetto di callback. A questo punto, l'applicazione deve chiamare IMFByteStream::EndRead per completare la richiesta asincrona.

Non leggere, scrivere in, liberare o riallocare il buffer mentre una lettura asincrona è in sospeso.

Note sull'implementazione:Questo metodo deve aggiornare la posizione corrente nel flusso aggiungendo il numero di byte che verranno letti, che viene specificato dal valore restituito nel parametro pcbRead , alla posizione corrente. Altri metodi che possono aggiornare la posizione corrente sono BeginRead, Write, BeginWrite, Seek e SetCurrentPosition.

Questa interfaccia è disponibile nelle piattaforme seguenti se vengono installati i componenti ridistribuibili di Windows Media Format 11 SDK:

• Windows XP con Service Pack 2 (SP2) e versioni successive.
• Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Requisiti

Vedi anche

IMFByteStream