Méthode IRenderEngine::SetSourceNameValidation

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]

La SetSourceNameValidation méthode spécifie comment le moteur de rendu valide les noms de fichiers.

Syntaxe

HRESULT SetSourceNameValidation(
   BSTR          FilterString,
   IMediaLocator *pOverride,
   LONG          Flags
);

Paramètres

FilterString

Valeur BSTR contenant des paires de chaînes de filtre, mises en forme selon les besoins du membre lpstrFilter de la structure OPENFILENAME . Le localisateur de média utilise ce filtre s’il présente une boîte de dialogue Ouvrir un fichier à l’utilisateur final.

pOverride

Pointeur facultatif vers l’interface IMediaLocator d’un localisateur de média à utiliser à la place de la valeur par défaut. Pour utiliser le localisateur de média par défaut, définissez la valeur de ce paramètre sur NULL. Pour plus d'informations, consultez la section Notes.

Indicateurs

Combinaison au niveau du bit d’indicateurs de validation de nom de fichier spécifiant le comportement du localisateur de média. L’indicateur SFN_VALIDATEF_CHECK doit être présent. L’indicateur SFN_VALIDATEF_hlinkMUTED n’a aucun effet avec cette méthode.

Valeur renvoyée

Retourne l’une des valeurs HRESULT suivantes :

Notes

À l’aide du paramètre pOverride , vous pouvez fournir votre propre implémentation personnalisée de l’interface IMediaLocator . Par exemple, le localisateur de média par défaut n’informe pas une application des fichiers qu’elle trouve (ou qu’elle ne peut pas trouver). 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. Passez ensuite les appels IMediaLocator::FindMediaFile directement à la version par défaut et examinez la valeur de retour.

Actuellement, cette méthode ne valide pas les sources chargées dynamiquement. Consultez IRenderEngine::SetDynamicReconnectLevel.

Configuration requise

Voir aussi

IRenderEngine, interface

Codes d’erreur et de réussite