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.]
Notes
[Déconseillé. Cette API peut être supprimée des versions ultérieures de Windows.]
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 :
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
Échec de l’initialisation du moteur de rendu. |
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.
Notes
Le fichier d’en-tête Qedit.h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.
Notes
Pour obtenir Qedit.h, téléchargez Microsoft Windows SDK Update 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