Funzione FilterInstanceCreate (fltuser.h)

La funzione FilterInstanceCreate crea un handle che può essere usato per comunicare con l'istanza di minifilter specificata.

Sintassi

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

Parametri

[in] lpFilterName

Puntatore a una stringa di caratteri wide con terminazione Null contenente il nome del minifilter proprietario dell'istanza.

[in] lpVolumeName

Puntatore a una stringa di caratteri wide con terminazione Null contenente il nome del volume a cui è collegata l'istanza.

La stringa di input lpVolumeName può essere una delle seguenti. La barra rovesciata finale (\) è facoltativa.

• Lettera di unità, ad esempio "D:\"
• Percorso di un punto di montaggio del volume, ad esempio "c:\mnt\edrive\"
• Identificatore di volume univoco (detto anche nome GUID del volume), ad esempio "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
• Nome del dispositivo non permanente (detto anche nome di destinazione o nome di dispositivo NT), ad esempio "\Device\HarddiskVolume1\"

[in, optional] lpInstanceName

Puntatore a una stringa di caratteri wide con terminazione Null contenente il nome dell'istanza per l'istanza. Questo parametro è facoltativo e può essere NULL. Se è NULL, viene restituita la prima istanza trovata per questo minifilter in questo volume.

[out] hInstance

Puntatore a una variabile allocata dal chiamante che riceve un handle opaco per l'istanza del minifilter se la chiamata a FilterInstanceCreate ha esito positivo; in caso contrario, riceve INVALID_HANDLE_VALUE.

Valore restituito

FilterInstanceCreate restituisce S_OK in caso di esito positivo. In caso contrario, restituisce un valore di errore.

Commenti

Un'applicazione in modalità utente chiama FilterInstanceCreate per creare un handle che può essere usato per comunicare con un'istanza minifilter in modalità kernel. L'handle di istanza restituito può essere passato come parametro a funzioni come FilterInstanceGetInformation.

Per chiudere un handle di istanza restituito da FilterInstanceCreate, chiamare FilterInstanceClose.

Requisiti

Vedi anche

FilterInstanceClose

FilterInstanceGetInformation