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

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.

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

Voir aussi

IMFSourceResolver

Programme de résolution de source