FilterInstanceCreate-Funktion (fltuser.h)
Die FilterInstanceCreate-Funktion erstellt ein Handle, das für die Kommunikation mit dem angegebenen Minifilter instance verwendet werden kann.
Syntax
HRESULT FilterInstanceCreate(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName,
[out] HFILTER_INSTANCE *hInstance
);
Parameter
[in] lpFilterName
Zeiger auf eine mit NULL beendete breitzeichenige Zeichenfolge, die den Namen des Minifilters enthält, der die instance besitzt.
[in] lpVolumeName
Zeiger auf eine mit NULL beendete Breitzeichenzeichenfolge, die den Namen des Volumes enthält, an das das instance angefügt ist.
Die LpVolumeName-Eingabezeichenfolge kann eine der folgenden Sein: Der nachfolgende umgekehrte Schrägstrich (\) ist optional.
- Ein Laufwerkbuchstabe, z. B. "D:\"
- Ein Pfad zu einem Volumeeinbindungspunkt, z. B. "c:\mnt\edrive\"
- Ein eindeutiger Volumebezeichner (auch als Volume-GUID-Name bezeichnet), z. B. "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
- Ein nichtpersistent-Gerätename (auch als Zielname oder NT-Gerätename bezeichnet), z. B. "\Device\HarddiskVolume1\"
[in, optional] lpInstanceName
Zeiger auf eine mit NULL beendete Breitzeichenzeichenfolge, die den instance Namen für die instance enthält. Dieser Parameter ist optional und kann NULL sein. Wenn es NULL ist, wird der erste instance für diesen Minifilter auf diesem Volume zurückgegeben.
[out] hInstance
Zeiger auf eine vom Aufrufer zugewiesene Variable, die ein undurchsichtiges Handle für den Minifilter empfängt instance, wenn der Aufruf von FilterInstanceCreate erfolgreich ist, andernfalls erhält er INVALID_HANDLE_VALUE.
Rückgabewert
FilterInstanceCreate gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein Fehlerwert zurückgegeben.
Hinweise
Eine Benutzermodusanwendung ruft FilterInstanceCreate auf, um ein Handle zu erstellen, das für die Kommunikation mit einem Kernelmodus-Minifilter instance verwendet werden kann. Das zurückgegebene instance-Handle kann als Parameter an Funktionen wie FilterInstanceGetInformation übergeben werden.
Um ein von FilterInstanceCreate zurückgegebenes instance-Handle zu schließen, rufen Sie FilterInstanceClose auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | fltuser.h (einschließlich Fltuser.h) |
| Bibliothek | FltLib.lib |
| DLL | FltLib.dll |