IMFSourceResolver::BeginCreateObjectFromURL, méthode (mfidl.h)

Article
08/24/2023

Commence une demande asynchrone pour créer une source multimédia ou un flux d’octets à partir d’une URL.

Syntaxe

HRESULT BeginCreateObjectFromURL(
  [in]  LPCWSTR          pwszURL,
  [in]  DWORD            dwFlags,
  [in]  IPropertyStore   *pProps,
  [out] IUnknown         **ppIUnknownCancelCookie,
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *punkState
);

Paramètres

[in] pwszURL

Chaîne terminée par null qui contient l’URL à résoudre.

[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 schéma ou au gestionnaire de flux d’octets qui crée l’objet . Le gestionnaire peut utiliser le magasin de propriétés pour configurer l’objet . Ce paramètre peut être NULL. Pour plus d’informations, consultez Configuration d’une source multimédia.

[out] ppIUnknownCancelCookie

Reçoit un pointeur IUnknown ou la valeur NULL. Si la valeur n’est pas NULL, vous pouvez annuler l’opération asynchrone en passant ce pointeur à la méthode IMFSourceResolver::CancelObjectCreation . L’appelant doit libérer l’interface. Ce paramètre peut être NULL.

[in] pCallback

Pointeur vers l’interface IMFAsyncCallback d’un objet de rappel. L’appelant doit implémenter cette interface.

[in] punkState

Pointeur vers l’interface IUnknown d’un objet d’état, défini par l’appelant. Ce paramètre peut être NULL. Vous pouvez utiliser cet objet pour stocker des informations d’état. L’objet est retourné à l’appelant lorsque le rappel est appelé.

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_SCHEME	Le schéma d’URL n’est pas pris en charge.

Notes

Le paramètre dwFlags doit contenir l’indicateur MF_RESOLUTION_MEDIASOURCE ou l’indicateur MF_RESOLUTION_BYTESTREAM, mais ne doit pas contenir les deux.

Pour les fichiers locaux, vous pouvez passer le nom de fichier dans le paramètre pwszURL ; le file: schéma n’est pas obligatoire.

Une fois l’opération terminée, le programme de résolution source appelle la méthode IMFAsyncCallback::Invoke . La méthode Invoke doit appeler IMFSourceResolver::EndCreateObjectFromURL pour obtenir un pointeur vers l’objet qui a été créé.

L’utilisation du paramètre pProps dépend de l’implémentation de la source du média.

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