Metodo IMFSourceResolver::CreateObjectFromByteStream (mfidl.h)

  • Articolo

Crea un'origine multimediale da un flusso di byte. Questo metodo è asincrono.

Sintassi

HRESULT CreateObjectFromByteStream(
  [in]  IMFByteStream  *pByteStream,
  [in]  LPCWSTR        pwszURL,
  [in]  DWORD          dwFlags,
  [in]  IPropertyStore *pProps,
  [out] MF_OBJECT_TYPE *pObjectType,
  [out] IUnknown       **ppObject
);

Parametri

[in] pByteStream

Puntatore all'interfaccia IMFByteStream del flusso di byte.

[in] pwszURL

Stringa con terminazione Null contenente l'URL del flusso di byte. L'URL è facoltativo e può essere NULL. Per ulteriori informazioni, vedere la sezione Osservazioni.

[in] dwFlags

OR bit per bit dei flag. Vedere Flag del resolver di origine.

[in] pProps

Puntatore all'interfaccia IPropertyStore di un archivio delle proprietà. Il metodo passa l'archivio delle proprietà al gestore del flusso di byte. Il gestore del flusso di byte può usare l'archivio delle proprietà per configurare l'origine multimediale. Questo parametro può essere NULL. Per altre informazioni, vedere Configurazione di un'origine multimediale.

[out] pObjectType

Riceve un membro dell'enumerazione MF_OBJECT_TYPE , specificando il tipo di oggetto creato.

[out] ppObject

Riceve un puntatore all'interfaccia IUnknown dell'origine multimediale. Il chiamante deve rilasciare l'interfaccia.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
 Il metodo è riuscito.
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS
 Il parametro dwFlags contiene flag che si escludono a vicenda.
MF_E_UNSUPPORTED_BYTESTREAM_TYPE
 Questo flusso di byte non è supportato.

Commenti

Il parametro dwFlags deve contenere il flag MF_RESOLUTION_MEDIASOURCE e non deve contenere il flag MF_RESOLUTION_BYTESTREAM .

Il resolver di origine tenta di trovare uno o più gestori di flusso di byte per il flusso di byte, in base all'estensione del nome file dell'URL o al tipo MIME del flusso di byte (o entrambi). L'URL viene specificato nel parametro pwszURL facoltativo e il tipo MIME può essere specificato nell'attributo MF_BYTESTREAM_CONTENT_TYPE nel flusso di byte. I gestori del flusso di byte vengono registrati dall'estensione del nome file o dal tipo MIME o entrambi, come descritto in Gestori schemi e gestori Byte-Stream. Il chiamante deve specificare almeno uno di questi valori (se possibile):

  • Specificare l'URL nel parametro pwszURL .
  • Specificare il tipo MIME impostando l'attributo MF_BYTESTREAM_CONTENT_TYPE nel flusso di byte. Questo attributo potrebbe essere impostato già quando si crea il flusso di byte, a seconda della modalità di creazione del flusso di byte.
Nota Questo metodo non può essere chiamato in modalità remota.
 

Requisiti

   
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione mfidl.h
Libreria Mfuuid.lib

Vedi anche

IMFSourceResolver

Resolver di origine