IMediaLocator :: FindMediaFile, méthode

Notes

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

La FindMediaFile méthode recherche un fichier et, en cas de réussite, récupère le chemin d’accès au fichier.

Syntaxe

HRESULT FindMediaFile(
   BSTR Input,
   BSTR FilterString,
   BSTR *pOutput,
   long Flags
);

Paramètres

Input

Nom du fichier, y compris le chemin d’accès, où le fichier a été connu pour la dernière fois. Pour les objets source de la chronologie, utilisez le nom du support actuel.

FilterString

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 affiche une boîte de dialogue Ouvrir un fichier. La valeur peut être null si le paramètre Flags n’inclut pas l' _ _ indicateur Popup SFN VALIDATEF.

pOutput

Pointeur vers une variable qui reçoit le chemin d’accès réel au fichier, s’il diffère de la valeur contenue dans l' entrée et si la méthode parvient à localiser le fichier.

Indicateurs

Combinaison d’opérations de bits de zéro ou plusieurs indicateurs. Pour obtenir la liste des indicateurs possibles, consultez indicateurs de validation du nom de fichier.

Valeur de retour

Si cette méthode est réussie, elle retourne la valeur _ OK. Sinon, elle retourne un code d’erreur HRESULT .

Notes

La chaîne de filtre de la boîte de dialogue d’ouverture de fichier, qui est spécifiée par le paramètre FilterString , contient des caractères null internes. Par exemple, \ la vidéo 0 *.avi\ 0 \ 0 est une chaîne de filtre valide. Vous ne pouvez pas utiliser la fonction SysAllocStr pour allouer le BSTR, car cette fonction attend une chaîne terminée par le caractère null et va tronquer la chaîne au premier caractère null. Par conséquent, utilisez une fonction telle que SysAllocStringLen, qui comprend un paramètre explicite pour la longueur :

BSTR filter = SysAllocStringLen(L"Video\0*.avi\0", 12);
// Note: SysAllocStringLen appends an additional '\0' to the string.

Si l’utilisateur annule la boîte de dialogue d’ouverture de fichier, la méthode renvoie E _ Fail.

La méthode alloue de la mémoire pour le BSTR dans pOutput. L’application doit appeler SysFreeString pour libérer la mémoire.

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.

Spécifications

Condition requise Valeur
En-tête
Qedit. h
Bibliothèque
Strmiids. lib

Voir aussi

Interface IMediaLocator

Codes d’erreur et de réussite