Macro FsRtlLookupPerStreamContext (ntifs.h)
La macro FsRtlLookupPerStreamContext recupera una estructura de contexto por secuencia para una secuencia de archivos.
Sintaxis
void FsRtlLookupPerStreamContext(
_sc,
_oid,
_iid
);
Parámetros
_sc
Puntero a la estructura FSRTL_ADVANCED_FCB_HEADER de la secuencia de archivos. Para obtener este puntero desde un objeto de archivo, use la macro FsRtlGetPerStreamContextPointer .
_oid
Puntero a una variable asignada por el autor de la llamada que identifica de forma única el propietario de la estructura de contexto por secuencia. El formato de esta variable es el controlador de filtro - específico. Debe ser distinto de NULL si se proporciona un valor distinto de NULL para InstanceId.
_iid
Puntero a un controlador de filtro : variable asignada que se puede usar para distinguir entre las estructuras de contexto por secuencia creadas por el mismo controlador de filtro. El formato de esta variable es el controlador de filtro - específico.
Si OwnerId e InstanceId son NULL, FsRtlLookupPerStreamContext devuelve el primer contexto por secuencia encontrado.
Si se proporciona un valor distinto de NULL para OwnerId e InstanceId es NULL, FsRtlLookupPerStreamContext devuelve el primer contexto por secuencia encontrado cuyo miembro OwnerId coincide con el parámetro OwnerId .
Valor devuelto
None
Observaciones
Un controlador de filtro del sistema de archivos llama a FsRtlLookupPerStreamContext para recuperar su estructura de contexto por secuencia para una secuencia de archivos. La estructura de contexto por secuencia contiene información de contexto que mantiene el controlador de filtro para la secuencia de archivos.
Para asociar una estructura de contexto por secuencia inicializada con una secuencia de archivos, llame a FsRtlInsertPerStreamContext.
Para quitar una estructura de contexto por secuencia asociada a una secuencia de archivos, llame a FsRtlRemovePerStreamContext.
Para obtener más información, vea Seguimiento de Per-Stream contexto en un controlador de filtro del sistema de archivos heredado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Paquete acumulativo de actualizaciones de Windows 2000 SP4; Windows XP |
| Plataforma de destino | Escritorio |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Consulte también
FsRtlGetPerStreamContextPointer