Metodo IMFHttpDownloadRequest::BeginReadPayload (mfidl.h)

Richiamato da Microsoft Media Foundation per ricevere il corpo del messaggio della risposta a una richiesta HTTP o HTTPS inviata in precedenza. Media Foundation richiama questo metodo solo dopo aver richiamato correttamente il metodo EndReceiveResponse . Poiché le dimensioni del corpo del messaggio possono essere grandi o sconosciute, Media Foundation può richiamare questo metodo più volte per recuperare il corpo del messaggio in modo a fasi.

Sintassi

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

Parametri

[out] pb

Puntatore a un buffer che riceve i dati.

[in] cb

Specifica le dimensioni del buffer pb , in byte.

[in] pCallback

Puntatore all'interfaccia IMFAsyncCallback di un oggetto callback implementato da Microsoft Media Foundation.

punkState

Puntatore all'interfaccia IUnknown di un oggetto stato, definita da Microsoft Media Foundation. Questo parametro può essere NULL.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non solo, quelli nella tabella seguente.

Codice restituito Descrizione
S_OK
L'operazione asincrona è stata avviata correttamente.

Osservazioni:

Microsoft Media Foundation non richiama mai BeginReadPayload mentre una chiamata precedente a BeginReadPayload non è ancora stata completata.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1703 [solo app desktop]
Server minimo supportato Nessuna supportata
Piattaforma di destinazione Windows
Intestazione mfidl.h
Library Mfplat.lib
DLL Mfplat.dll

Vedere anche

IMFHttpDownloadRequest