Macro FsRtlLookupPerStreamContext (ntifs.h)

Articolo
03/08/2023

La macro FsRtlLookupPerStreamContext recupera una struttura di contesto per flusso per un flusso di file.

Sintassi

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

Parametri

_sc

Puntatore alla struttura FSRTL_ADVANCED_FCB_HEADER per il flusso di file. Per ottenere questo puntatore da un oggetto file, usare la macro FsRtlGetPerStreamContextPointer .

_oid

Puntatore a una variabile allocata dal chiamante che identifica in modo univoco il proprietario della struttura di contesto per flusso. Il formato di questa variabile è il driver di filtro - specifico. Deve essere diverso da NULL se viene fornito un valore non NULL per InstanceId.

_iid

Puntatore a un driver di filtro - variabile allocata che può essere usata per distinguere tra le strutture di contesto per flusso create dallo stesso driver di filtro. Il formato di questa variabile è il driver di filtro - specifico.

Se OwnerId e InstanceId sono entrambi NULL, FsRtlLookupPerStreamContext restituisce il primo contesto per flusso trovato.

Se viene fornito un valore non NULL per OwnerId e InstanceId è NULL, FsRtlLookupPerStreamContext restituisce il primo contesto per flusso trovato il cui membro OwnerId corrisponde al parametro OwnerId .

Valore restituito

nessuno

Osservazioni

Un driver di filtro del file system chiama FsRtlLookupPerStreamContext per recuperare la struttura del contesto per flusso per un flusso di file. La struttura del contesto per flusso contiene informazioni di contesto che il driver di filtro gestisce per il flusso di file.

NotaFsRtlLookupPerStreamContext può essere usato solo nei file system che supportano contesti per flusso.

Per inizializzare una struttura di contesto per flusso, usare la macro FsRtlInitPerStreamContext .

Per associare una struttura di contesto inizializzata per flusso a un flusso di file, chiamare FsRtlInsertPerStreamContext.

Per rimuovere una struttura di contesto per flusso associata a un flusso di file, chiamare FsRtlRemovePerStreamContext.

Per altre informazioni, vedere Rilevamento Per-Stream contesto in un driver di filtro del file system legacy.

Requisiti

Requisito	Valore
Client minimo supportato	Aggiornamento cumulativo di Windows 2000 SP4; Windows XP
Piattaforma di destinazione	Desktop
Intestazione	ntifs.h (include Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL