FLT_RELATED_CONTEXTS-Struktur (fltkernel.h)

Artikel
02/29/2024

Die FLT_RELATED_CONTEXTS-Struktur enthält die Kontexte eines Minifiltertreibers für die Objekte, die einem E/A-Vorgang zugeordnet sind.

Syntax

typedef struct _FLT_RELATED_CONTEXTS {
  PFLT_CONTEXT VolumeContext;
  PFLT_CONTEXT InstanceContext;
  PFLT_CONTEXT FileContext;
  PFLT_CONTEXT StreamContext;
  PFLT_CONTEXT StreamHandleContext;
  PFLT_CONTEXT TransactionContext;
} FLT_RELATED_CONTEXTS, *PFLT_RELATED_CONTEXTS;

Member

VolumeContext

Undurchsichtiger Zeiger auf den Kontext des Minifilters für das Volume, auf das der Volume-Member der FLT_RELATED_OBJECTS-Struktur zeigt.

InstanceContext

Undurchsichtiger Zeiger auf den Kontext des Minifiltertreibers für die instance, auf die der Instanzmember der FLT_RELATED_OBJECTS-Struktur zeigt.

FileContext

Unter Windows Vista und höher ist dieser Member ein undurchsichtiger Zeiger auf den Dateikontext des Minifiltertreibers für das Streamhandle, auf das das FileObject-Element der FLT_RELATED_OBJECTS-Struktur verweist. Unter Windows-Betriebssystemen vor Windows Vista ist dieses Mitglied für die Systemverwendung reserviert.

StreamContext

Undurchsichtiger Zeiger auf den Streamkontext des Minifilters für das Streamhandle, auf das der FileObject-Member der FLT_RELATED_OBJECTS-Struktur zeigt.

StreamHandleContext

Undurchsichtiger Zeiger auf den Streamhandlekontext des Minifilters für das Streamhandle, auf das der FileObject-Member der FLT_RELATED_OBJECTS-Struktur zeigt.

TransactionContext

Unter Windows Vista und höher ist dieser Member ein undurchsichtiger Zeiger auf den Transaktionskontext des Minifilters für die Transaktion, auf die der Transaction-Member der FLT_RELATED_OBJECTS-Struktur zeigt. Unter Windows-Betriebssystemen vor Windows Vista ist dieses Mitglied für die Systemverwendung reserviert.

Hinweise

Die FLT_RELATED_CONTEXTS-Struktur enthält die Kontexte eines Minifiltertreibers für die Objekte, die einem E/A-Vorgang oder einem instance Setup- oder Abbruchvorgang zugeordnet sind.

Ein Minifiltertreiber verwendet die FLT_RELATED_CONTEXTS-Struktur , um mehrere Kontexte für einen bestimmten Vorgang abzurufen. Dazu ordnet der Minifiltertreiber eine leere FLT_RELATED_CONTEXTS-Struktur zu und übergibt einen Zeiger als Contexts-Parameter an FltGetContexts.

Ein Minifilter kann diese Struktur auch verwenden, um mehrere Kontexte für einen bestimmten Vorgang freizugeben. Dazu übergibt der Minifiltertreiber einen Zeiger an FLT_RELATED_CONTEXTS als Contexts-Parameter an FltReleaseContexts.

Weitere Informationen zur Verwendung von Kontexten finden Sie im Referenzeintrag für FltAllocateContext.