FilterInstanceCreate, fonction (fltuser.h)

La fonction FilterInstanceCreate crée un handle qui peut être utilisé pour communiquer avec le minifiltre instance donné.

Syntaxe

HRESULT FilterInstanceCreate(
  [in]           LPCWSTR          lpFilterName,
  [in]           LPCWSTR          lpVolumeName,
  [in, optional] LPCWSTR          lpInstanceName,
  [out]          HFILTER_INSTANCE *hInstance
);

Paramètres

[in] lpFilterName

Pointeur vers une chaîne de caractères larges terminée par null contenant le nom du minifiltre qui possède le instance.

[in] lpVolumeName

Pointeur vers une chaîne de caractères larges terminée par un caractère null contenant le nom du volume auquel le instance est attaché.

La chaîne d’entrée lpVolumeName peut être l’une des valeurs suivantes. La barre oblique inverse de fin (\) est facultative.

• Une lettre de lecteur, telle que « D :\ »
• Chemin d’accès à un point de montage de volume, tel que « c :\mnt\edrive\ »
• Un identificateur de volume unique (également appelé nom GUID de volume), tel que « \ ? » \Volume{7603f260-142a-11d4-ac67-806d6172696f}\ »
• Un nom d’appareil non persistant (également appelé nom de cible ou nom d’appareil NT), tel que « \Device\HarddiskVolume1\ »

[in, optional] lpInstanceName

Pointeur vers une chaîne de caractères larges terminée par null contenant le nom instance pour le instance. Ce paramètre est facultatif et peut être NULL. S’il a la valeur NULL, la première instance trouvée pour ce minifiltre sur ce volume est retournée.

[out] hInstance

Pointeur vers une variable allouée par l’appelant qui reçoit un handle opaque pour le minifilter instance si l’appel à FilterInstanceCreate réussit ; sinon, il reçoit INVALID_HANDLE_VALUE.

Valeur retournée

FilterInstanceCreate retourne S_OK en cas de réussite. Sinon, elle retourne une valeur d’erreur.

Remarques

Une application en mode utilisateur appelle FilterInstanceCreate pour créer un handle qui peut être utilisé pour communiquer avec un minifiltre en mode noyau instance. Le handle de instance retourné peut être passé en tant que paramètre à des fonctions telles que FilterInstanceGetInformation.

Pour fermer un handle instance retourné par FilterInstanceCreate, appelez FilterInstanceClose.

Configuration requise

Voir aussi

FilterInstanceClose

FilterInstanceGetInformation