IAMTimeline::ValidateSourceNames, méthode
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
Notes
[Déconseillé. Cette API peut être supprimée des versions ultérieures de Windows.]
La ValidateSourceNames méthode valide les noms de sources dans le chronologie, à l’aide du localisateur multimédia. Éventuellement, cette méthode met également à jour tout objet source pour lequel elle localise un fichier.
Syntaxe
HRESULT ValidateSourceNames(
long ValidateFlags,
IMediaLocator *pOverride,
long NotifyEventHandle
);
Paramètres
-
ValidateFlags
-
Combinaison au niveau du bit d’indicateurs de validation de nom de fichier spécifiant le comportement du localisateur multimédia. Les indicateurs SFN_VALIDATEF_REPLACE et SFN_VALIDATEF_CHECK doivent être présents, ou la méthode retourne E_INVALIDARG.
-
pOverride
-
Pointeur facultatif vers l’interface IMediaLocator d’un localisateur multimédia à utiliser à la place de la valeur par défaut. Pour utiliser le localisateur multimédia par défaut, définissez la valeur de ce paramètre sur NULL. Pour plus d'informations, consultez la section Notes.
-
NotifyEventHandle
-
Handle vers un événement. La méthode signale l’événement une fois la validation terminée.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Notes
À l’aide du paramètre pOverride , vous pouvez fournir votre propre implémentation personnalisée de l’interface IMediaLocator . Par exemple, le localisateur multimédia par défaut n’informe pas votre application des fichiers qu’elle trouve (ou qu’elle ne trouve pas). Pour contourner cette limitation, vous pouvez implémenter un localisateur de média personnalisé, ce qui en fait un wrapper pour la version par défaut. Dans votre version personnalisée, transmettez les appels IMediaLocator::FindMediaFile directement à la version par défaut et examinez la valeur de retour.
Remarque
Le fichier d’en-tête Qedit.h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.
Remarque
Pour obtenir Qedit.h, téléchargez la mise à jour Microsoft Windows SDK pour Windows Vista et .NET Framework 3.0. Qedit.h n’est pas disponible dans le Microsoft Windows SDK pour Windows 7 et .NET Framework 3.5 Service Pack 1.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi