MÉTHODE IMFSourceResolver::CreateObjectFromByteStream (mfidl.h)

Article
08/24/2023

Crée une source multimédia à partir d’un flux d’octets. Cette méthode est synchrone.

Syntaxe

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

Paramètres

[in] pByteStream

Pointeur vers l’interface IMFByteStream du flux d’octets.

[in] pwszURL

Chaîne terminée par null qui contient l’URL du flux d’octets. L’URL est facultative et peut être NULL. Pour plus d'informations, consultez la section Notes.

[in] dwFlags

OR au niveau du bit des indicateurs. Consultez Indicateurs du programme de résolution de source.

[in] pProps

Pointeur vers l’interface IPropertyStore d’un magasin de propriétés. La méthode transmet le magasin de propriétés au gestionnaire de flux d’octets. Le gestionnaire de flux d’octets peut utiliser le magasin de propriétés pour configurer la source du média. Ce paramètre peut être NULL. Pour plus d’informations, consultez Configuration d’une source multimédia.

[out] pObjectType

Reçoit un membre de l’énumération MF_OBJECT_TYPE , spécifiant le type d’objet qui a été créé.

[out] ppObject

Reçoit un pointeur vers l’interface IUnknown de la source multimédia. L’appelant doit libérer l’interface.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS	Le paramètre dwFlags contient des indicateurs mutuellement exclusifs.
MF_E_UNSUPPORTED_BYTESTREAM_TYPE	Ce flux d’octets n’est pas pris en charge.

Notes

Le paramètre dwFlags doit contenir l’indicateur MF_RESOLUTION_MEDIASOURCE et ne doit pas contenir l’indicateur MF_RESOLUTION_BYTESTREAM .

Le programme de résolution source tente de trouver un ou plusieurs gestionnaires de flux d’octets pour le flux d’octets, en fonction de l’extension de nom de fichier de l’URL ou du type MIME du flux d’octets (ou les deux). L’URL est spécifiée dans le paramètre facultatif pwszURL , et le type MIME peut être spécifié dans l’attribut MF_BYTESTREAM_CONTENT_TYPE sur le flux d’octets. Les gestionnaires de flux d’octets sont inscrits par extension de nom de fichier ou par type MIME, ou les deux, comme décrit dans Gestionnaires de schémas et gestionnaires de Byte-Stream. L’appelant doit spécifier au moins l’une de ces valeurs (les deux si possible) :

Spécifiez l’URL dans le paramètre pwszURL .
Spécifiez le type MIME en définissant l’attribut MF_BYTESTREAM_CONTENT_TYPE sur le flux d’octets. (Cet attribut peut être déjà défini lorsque vous créez le flux d’octets, selon la façon dont le flux d’octets a été créé.)

Note Cette méthode ne peut pas être appelée à distance.

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mfuuid.lib

Voir aussi

IMFSourceResolver

Programme de résolution de source

Partager via