IO_SESSION_NOTIFICATION_FUNCTION Rückruffunktion (wdm.h)

Der funktionstyp IO_SESSION_NOTIFICATION_FUNCTION definiert eine Rückrufroutine, über die ein Treiber Benachrichtigungen über Änderungen im Status von Benutzersitzungen empfängt, an denen der Treiber interessiert ist.

Syntax

IO_SESSION_NOTIFICATION_FUNCTION IoSessionNotificationFunction;

NTSTATUS IoSessionNotificationFunction(
  [in] PVOID SessionObject,
  [in] PVOID IoObject,
  [in] ULONG Event,
  [in] PVOID Context,
  [in] PVOID NotificationPayload,
  [in] ULONG PayloadLength
)
{...}

Parameter

[in] SessionObject

Zeigen Sie auf ein undurchsichtiges Systemobjekt, das Informationen zur Benutzersitzung enthält. Der Treiber kann diesen Zeigerwert an die IoGetContainerInformation Routine als ContainerObject Parameterwert übergeben.

[in] IoObject

Zeiger auf ein E/A-Objekt, das dem Treiber gehört. Dieser Parameter ist der E/A-Objektzeiger, den der Treiber an die IoRegisterContainerNotification Routine übermittelt hat, wenn der Treiber zuvor registriert wurde, um Benachrichtigungen über Sitzungsereignisse zu empfangen. Der IoRegisterContainerNotificationNotificationInformation Parameter verweist auf eine IO_SESSION_STATE_NOTIFICATION Struktur, deren IoObject Member auf das E/A-Objekt verweist.

[in] Event

Eine IO_SESSION_EVENT Enumerationskonstante, die angibt, welches Sitzungsereignis den Benachrichtigungsrückruf verursacht hat.

[in] Context

Der Kontextwert, den der Treiber zuvor für die IoRegisterContainerNotification bereitgestellt hat, Routine, wenn der Treiber registriert wurde, um Benachrichtigungen über Sitzungsereignisse zu empfangen. Im IoRegisterContainerNotification Aufruf hat der Treiber einen Zeiger auf eine IO_SESSION_STATE_NOTIFICATION Struktur bereitgestellt, deren Context Member den Kontextwert enthält.

[in] NotificationPayload

Zeigen Sie auf einen Nutzlastpuffer, der eine IO_SESSION_CONNECT_INFO Struktur enthält.

[in] PayloadLength

Die Größe des Puffers in Bytes, auf den NotificationPayloadverweist. Die Puffergröße muss niemals den Konstantenwert IO_SESSION_MAX_PAYLOAD_SIZE überschreiten, der in der Wdm.h-Headerdatei definiert ist.

Rückgabewert

Wenn die Routine erfolgreich ist, muss sie STATUS_SUCCESS zurückgeben. Andernfalls muss eine der Fehlerstatuswerte zurückgegeben werden, die in der Ntstatus.h-Headerdatei definiert sind.

Bemerkungen

Ein Kernelmodustreiber implementiert diese Routine. Der E/A-Manager ruft diese Routine auf, um den Treiber über Sitzungsereignisse zu benachrichtigen.

Um Benachrichtigungen über Sitzungsereignisse zu empfangen, ruft ein Treiber die IoRegisterContainerNotification Routine auf und legt den CallbackFunction-Parameter dieser Routine so fest, dass er auf die IO_SESSION_NOTIFICATION_FUNCTION Routine des Treibers verweist. Das I/O-Objekt, das der Treiber an IoRegisterContainerNotification übergibt bestimmt, ob der Treiber Benachrichtigungen über Ereignisse in einer bestimmten Benutzersitzung oder von Ereignissen in allen Sitzungen empfängt. Weitere Informationen finden Sie unter IO_SESSION_STATE_NOTIFICATION.

Beispiele

Um eine E/A-Sitzungsbenachrichtigungsroutine zu definieren, müssen Sie zuerst eine Funktionsdeklaration bereitstellen, die den Typ der von Ihnen definierten Rückrufroutine identifiziert. Windows stellt eine Reihe von Rückruffunktionstypen für Treiber bereit. Durch das Deklarieren einer Funktion mithilfe der Rückruffunktionstypen können Codeanalyse für Treiber, statische Treiberüberprüfung (SDV) und andere Überprüfungstools Fehler finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine I/O-Sitzungsbenachrichtigungsroutine zu definieren, die MyIoSessionNotificationgenannt wird, verwenden Sie den IO_SESSION_NOTIFICATION_FUNCTION Typ, wie in diesem Codebeispiel gezeigt:

IO_SESSION_NOTIFICATION_FUNCTION MyIoSessionNotification;

Implementieren Sie dann Ihre Rückrufroutine wie folgt:

_Use_decl_annotations_
NTSTATUS
  MyIoSessionNotification(
    PVOID  SessionObject,
    PVOID  IoObject,
    ULONG  Event,
    PVOID  Context,
    PVOID  NotificationPayload,
    ULONG  PayloadLength
    )
  {
      // Function body
  }

Der IO_SESSION_NOTIFICATION_FUNCTION Funktionstyp wird in der Wdm.h-Headerdatei definiert. Um Fehler genauer zu identifizieren, wenn Sie die Codeanalysetools ausführen, müssen Sie der Funktionsdefinition die _Use_decl_annotations_ Anmerkung hinzufügen. Die _Use_decl_annotations_ Anmerkung stellt sicher, dass die Anmerkungen, die auf den IO_SESSION_NOTIFICATION_FUNCTION Funktionstyp in der Headerdatei angewendet werden, verwendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für WDM-Treiber. Informationen zu _Use_decl_annotations_finden Sie unter Annotating Function Behavior.

Anforderungen

Siehe auch

IO_SESSION_CONNECT_INFO

IO_SESSION_EVENT

IO_SESSION_STATE_NOTIFICATION

IoGetContainerInformation-

IoRegisterContainerNotification-