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 |
|---|---|
|
Réussite. |
|
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 |
|
| Bibliothèque |
|