DRIVER_FS_NOTIFICATION Rückruffunktion (ntifs.h)

Artikel
02/26/2024

Eine PDRIVER_FS_NOTIFICATION typisierte Routine wird vom Betriebssystem aufgerufen, wenn sich ein Dateisystem mithilfe von IoRegisterFileSystem oder IoUnregisterFileSystem registriert oder die Registrierung auf hebt.

Syntax

DRIVER_FS_NOTIFICATION DriverFsNotification;

void DriverFsNotification(
  [in] _DEVICE_OBJECT *DeviceObject,
  [in] BOOLEAN FsActive
)
{...}

Parameter

[in] DeviceObject

Ein Zeiger auf ein Dateisystemgeräteobjekt, für das die Benachrichtigung aufgerufen wurde.

[in] FsActive

Ein boolescher Wert, der angibt, ob das Dateisystem selbst als aktives Dateisystem registriert (TRUE) oder nicht registriert (FALSE) ist.

Rückgabewert

Keine

Bemerkungen

Sie müssen die Rückruffunktion mit dem typ DRIVER_FS_NOTIFICATION deklarieren. Weitere Informationen finden Sie im folgenden Beispielabschnitt.

Beispiele

Um eine DriverFSNotificationRoutine-Rückrufroutine mit dem Namen MyDriverNotification zu definieren, müssen Sie zunächst wie folgt eine Funktionsdeklaration bereitstellen, die die Statische Treiberüberprüfung (SDV) und andere Überprüfungstools erfordern:

DRIVER_FS_NOTIFICATION MyDriverFSNotification;

Implementieren Sie dann Ihre Rückrufroutine wie folgt:

VOID
MyDriverFSNotification (
    __in struct _DEVICE_OBJECT *DeviceObject,
    __in BOOLEAN FsActive
)
{ . . . }

Beachten Sie, dass der Rückruftyp in Ntifs.h wie folgt deklariert wird:

typedef
VOID
DRIVER_FS_NOTIFICATION (
  __in struct _DEVICE_OBJECT *DeviceObject,
  __in BOOLEAN FsActive
  );
typedef DRIVER_FS_NOTIFICATION *PDRIVER_FS_NOTIFICATION;