Método IMFHttpDownloadRequest::BeginReadPayload (mfidl.h)

Invocado por Microsoft Media Foundation para recibir el cuerpo del mensaje de la respuesta a una solicitud HTTP o HTTPS enviada previamente. Media Foundation invoca este método solo después de haber invocado correctamente el método EndReceiveResponse . Dado que el tamaño del cuerpo del mensaje puede ser grande o desconocido, Media Foundation puede invocar este método varias veces para recuperar el cuerpo del mensaje de forma por etapas.

Sintaxis

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

Parámetros

[out] pb

Puntero a un búfer que recibe los datos.

[in] cb

Especifica el tamaño del búfer pb , en bytes.

[in] pCallback

Puntero a la interfaz IMFAsyncCallback de un objeto de devolución de llamada implementado por Microsoft Media Foundation.

punkState

Puntero a la interfaz IUnknown de un objeto de estado, definido por Microsoft Media Foundation. Este parámetro puede ser NULL.

Valor de retorno

El método devuelve un HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente.

Observaciones

Microsoft Media Foundation nunca invoca BeginReadPayload mientras que una llamada anterior a BeginReadPayload aún no se ha completado.

Requisitos

Consulte también

IMFHttpDownloadRequest