Macro FsRtlLookupPerStreamContext (ntifs.h)
A macro FsRtlLookupPerStreamContext recupera uma estrutura de contexto por fluxo para um fluxo de arquivos.
Sintaxe
void FsRtlLookupPerStreamContext(
_sc,
_oid,
_iid
);
Parâmetros
_sc
Ponteiro para a estrutura FSRTL_ADVANCED_FCB_HEADER para o fluxo de arquivos. Para obter esse ponteiro de um objeto de arquivo, use a macro FsRtlGetPerStreamContextPointer .
_oid
Ponteiro para uma variável alocada pelo chamador que identifica exclusivamente o proprietário da estrutura de contexto por fluxo. O formato dessa variável é driver de filtro – específico. Deve ser não NULL se um valor não NULL for fornecido para InstanceId.
_iid
Ponteiro para um driver de filtro – variável alocada que pode ser usada para distinguir entre as estruturas de contexto por fluxo criadas pelo mesmo driver de filtro. O formato dessa variável é driver de filtro – específico.
Se OwnerId e InstanceId forem NULL, FsRtlLookupPerStreamContext retornará o primeiro contexto por fluxo encontrado.
Se um valor não NULL for fornecido para OwnerId e InstanceId for NULL, FsRtlLookupPerStreamContext retornará o primeiro contexto por fluxo encontrado cujo membro OwnerId corresponde ao parâmetro OwnerId .
Retornar valor
Nenhum
Comentários
Um driver de filtro do sistema de arquivos chama FsRtlLookupPerStreamContext para recuperar sua estrutura de contexto por fluxo para um fluxo de arquivos. A estrutura de contexto por fluxo contém informações de contexto que o driver de filtro mantém para o fluxo de arquivos.
Para associar uma estrutura de contexto por fluxo inicializada a um fluxo de arquivos, chame FsRtlInsertPerStreamContext.
Para remover uma estrutura de contexto por fluxo associada a um fluxo de arquivos, chame FsRtlRemovePerStreamContext.
Para obter mais informações, consulte Acompanhamento Per-Stream contexto em um driver de filtro do sistema de arquivos herdado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Pacote cumulativo de atualizações do Windows 2000 SP4; Windows XP |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ntifs.h (inclua Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Confira também
FsRtlGetPerStreamContextPointer