Metodo IMFByteStream::BeginWrite (mfobjects.h)

Avvia un'operazione di scrittura asincrona nel flusso.

Sintassi

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

Parametri

[in] pb

Puntatore a un buffer contenente i dati da scrivere.

[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 stato, definito dal chiamante. Questo parametro può essere NULL. È possibile usare questo oggetto per contenere 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 scritti nel flusso, viene chiamato il metodo FMAsyncCallback dell'oggetto callback::Invoke . A questo punto, l'applicazione deve chiamare FMByteStream::EndWrite per completare la richiesta asincrona.

Non riallocare, liberare o scrivere nel buffer mentre una scrittura asincrona è ancora in sospeso.

Note sull'implementazione:Questo metodo deve aggiornare la posizione corrente nel flusso aggiungendo il numero di byte che verrà scritto nel flusso, specificato dal valore restituito nel pcbScritto, alla posizione corrente. Altri metodi che possono aggiornare la posizione corrente sono Read, BeginRead, Write, Seek e SetCurrentPosition.

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

• 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

FMByteStream