IRenderEngine :: SetSourceNameValidation, méthode

Notes

[Déconseillé. Cette API peut être supprimée des futures versions de Windows.]

La SetSourceNameValidation méthode spécifie la manière dont 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, au format requis par le 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, affectez la valeur null à ce paramètre. Pour plus d'informations, consultez la section Notes.

Indicateurs

Combinaison d’opérations de bits des indicateurs de validation de nom de fichier spécifiant le comportement du localisateur de média. L' _ indicateur de vérification SFN VALIDATEF _ doit être présent. L' _ indicateur SFN VALIDATEF _ hlinkMUTED n’a aucun effet avec cette méthode.

Valeur retournée

Retourne l’une des valeurs HRESULT suivantes :

Code de retour Description
_OK
Réussite.
E _ doit _ initialiser le _ convertisseur
Le moteur de rendu n’a pas pu s’initialiser.

Remarques

À 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’avertit pas une application des fichiers qu’elle trouve (ou 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. Ensuite, transmettez IMediaLocator :: FindMediaFile appelle 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 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
Qedit. h
Bibliothèque
Strmiids. lib

Voir aussi

Interface IRenderEngine

Codes d’erreur et de réussite