Metodo IMFHttpDownloadRequest::EndReadPayload (mfidl.h)

Richiamato da Microsoft Media Foundation per completare l'operazione asincrona avviata da BeginReadPayload. Al termine di questo metodo, i dati del payload verranno scritti nel buffer fornito da Media Foundation quando si richiama BeginReadPayload.

Sintassi

HRESULT EndReadPayload(
  [in]  IMFAsyncResult *pResult,
  [out] QWORD          *pqwOffset,
  [out] ULONG          *pcbRead
);

Parametri

[in] pResult

Puntatore all'interfaccia IMFAsyncResult . Microsoft Media Foundation passerà lo stesso puntatore ricevuto dal relativo oggetto callback nel metodo IMFAsyncCallback::Invoke.

[out] pqwOffset

Offset del primo byte scritto nel buffer, rispetto al corpo completo del messaggio della richiesta HTTP corrente. Ad esempio, quando Media Foundation richiama BeginReadPayload per la prima volta in un determinato IMFHttpDownloadRequest e specifica una dimensione del buffer pari a 100, il parametro pqwOffset verrà impostato su 0. Quindi, quando Media Foundation richiama BeginReadPayload per la seconda volta sulla stessa IMNFHttpDownloadRequest, il parametro pqwOffset verrà impostato su 100.

[out] pcbRead

Specifica il numero di byte scritti nel buffer fornito da Media Foundation quando si richiama BeginReadPayload. Si noti che questo valore deve essere sempre uguale alle dimensioni del buffer specificato in BeginReadPayload, a meno che la richiesta non sia riuscita o a meno che non sia stata raggiunta la fine del corpo del messaggio.

Valore restituito

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

Codice restituito Descrizione
S_OK
I dati sono stati scritti correttamente nel buffer fornito in BeginReadPayload.

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