Freigeben über


FsRtlGetPerStreamContextPointer-Makro (ntifs.h)

Das Makro FsRtlGetPerStreamContextPointer gibt den Streamkontext des Dateisystems für einen Dateistream zurück.

Syntax

void FsRtlGetPerStreamContextPointer(
   _fo
);

Parameter

_fo

Zeiger auf ein Dateiobjekt für den Dateistream.

Rückgabewert

Keine

Bemerkungen

Dateisystemfiltertreiber können das FsRtlGetPerStreamContextPointer-Makro verwenden, um einen Streamkontextzeiger für den Dateistream abzurufen, der durch ein bestimmtes Dateiobjekt dargestellt wird. Ein Streamkontextzeiger ist ein Zeiger auf den Streamkontext des Dateisystems für den Dateidatenstrom. Dieser Zeiger kann als Parameter an FsRtlInsertPerStreamContext, FsRtlLookupPerStreamContext und FsRtlRemovePerStreamContext übergeben werden.

Der Streamkontextzeiger verweist auf eine FSRTL_ADVANCED_FCB_HEADER Struktur, die den Dateidatenstrom zum Dateisystem eindeutig identifiziert. Diese Struktur ist in der Regel in ein Streamkontextobjekt eingebettet, z. B. in einen Dateisteuerungsblock (FCB) oder einen Streamsteuerungsblock (Stream Control Block, SCB). Wenn der Dateistream geöffnet wird, speichert das Dateisystem einen Zeiger auf den FCB oder SCB im FsContext-Element des Dateiobjekts .

Hinweis Das FsRtlGetPerStreamContextPointer-Makro kann nur auf Dateisystemen verwendet werden, die erweiterte FCB-Header unterstützen.
 
Weitere Informationen finden Sie unter Nachverfolgen Per-Stream Kontexts in einem Legacy-Dateisystemfiltertreiber.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP; Windows 2000 SP4 Updaterollup
Zielplattform Desktop
Kopfzeile ntifs.h (include Ntifs.h)
IRQL <= APC_LEVEL

Weitere Informationen

FSRTL_ADVANCED_FCB_HEADER

FsRtlInitPerStreamContext

FsRtlInsertPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSetupAdvancedHeader

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts