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

Comienza una operación de lectura asincrónica desde la secuencia.

Sintaxis

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

Parámetros

[in] pb

Puntero a un búfer que recibe los datos. El autor de la llamada debe asignar el búfer.

[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 se han leído todos los datos en el búfer, se llama al método IMFAsyncCallback::Invoke del objeto de devolución de llamada. En ese momento, la aplicación debe llamar a IMFByteStream::EndRead para completar la solicitud asincrónica.

No lea desde, escriba en, libere o reasigna el búfer mientras una lectura asincrónica está 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 leerán, que se especifica mediante el valor devuelto en el parámetro pcbRead , a la posición actual. Otros métodos que pueden actualizar la posición actual son BeginRead, Write, BeginWrite, 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) instalados.

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