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 de FSRTL_ADVANCED_FCB_HEADER do fluxo de arquivos. Para obter esse ponteiro de um objeto de arquivo, use a macroFsRtlGetPerStreamContextPointer.
_oid
Ponteiro para uma variável alocada por chamador que identifica exclusivamente o proprietário da estrutura de contexto por fluxo. O formato dessa variável é driver de filtro – específico. Deve serNULL não se um valor nulo 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 estiverem NULL, FsRtlLookupPerStreamContext retornará o primeiro contexto por fluxo encontrado.
Se um valorNULL não for fornecido para OwnerId e InstanceId NULL, FsRtlLookupPerStreamContext retornará o primeiro contexto por fluxo encontrado cujo membro OwnerId corresponde ao parâmetro OwnerId.
Valor de retorno
Nenhum
Observações
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 inicializada por fluxo 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 controle Per-Stream contexto em um driver de filtro do sistema de arquivos herdado.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Pacote cumulativo de atualizações do Windows 2000 SP4; Windows XP |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Consulte também
FsRtlGetPerStreamContextPointer