Método IMFByteStream::BeginWrite (mfobjects.h)

Inicia una operación de escritura asincrónica en la secuencia.

Sintaxis

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

Parámetros

[in] pb

Puntero a un búfer que contiene los datos que se van a escribir.

[in] cb

Tamaño del búfer en bytes.

[in] pCallback

Puntero a la interfaz IMFAsyncCallback de un objeto de devolución de llamada. El autor de la llamada debe implementar esta interfaz.

[in] punkState

Puntero a la interfaz IUnknown de un objeto de estado, definido por el autor de la llamada. Este parámetro puede ser NULL. Puede usar este objeto para contener información de estado. El objeto se devuelve al autor de la llamada cuando se invoca la devolución de llamada.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Cuando todos los datos se han escrito en la secuencia, se llama al método IMFAsyncCallback::Invoke del objeto de devolución de llamada. En ese momento, la aplicación debe llamar a IMFByteStream::EndWrite para completar la solicitud asincrónica.

No reasignar, liberar ni escribir en el búfer mientras una escritura asincrónica sigue pendiente.

Notas de implementación:Este método debe actualizar la posición actual en la secuencia agregando el número de bytes que se escribirán en la secuencia, especificado por el valor devuelto en pcbWritten, a la posición actual. Otros métodos que pueden actualizar la posición actual son Read, BeginRead, Write, Seek y SetCurrentPosition.

Esta interfaz está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

• Windows XP con Service Pack 2 (SP2) y versiones posteriores.
• Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	mfobjects.h (include Mfidl.h)
Library	Mfuuid.lib

Consulte también

IMFByteStream