Função FsRtlInsertPerStreamContext (ntifs.h)
A rotina FsRtlInsertPerStreamContext associa a estrutura de contexto por fluxo de um driver de filtro do sistema de arquivos a um fluxo de arquivos.
Sintaxe
NTSTATUS FsRtlInsertPerStreamContext(
PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
[in] PFSRTL_PER_STREAM_CONTEXT Ptr
);
Parâmetros
PerStreamContext
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 .
[in] Ptr
Ponteiro para uma estrutura FSRTL_PER_STREAM_CONTEXT que o driver de filtro alocou e inicializou. Para inicializar essa estrutura, use a macro FsRtlInitPerStreamContext .
Retornar valor
FsRtlInsertPerStreamContext retorna um dos seguintes valores NTSTATUS:
| Código de retorno | Descrição |
|---|---|
|
A chamada para FsRtlInsertPerStreamContext foi bem-sucedida. |
|
O sistema de arquivos subjacente não dá suporte a contextos de filtro. |
Comentários
Um driver de filtro do sistema de arquivos chama FsRtlInsertPerStreamContext para associar sua própria estrutura de contexto por fluxo a 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.
Depois que a estrutura de contexto por fluxo tiver sido associada a um fluxo de arquivos, ela poderá ser recuperada chamando FsRtlLookupPerStreamContext ou removida chamando 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 | Universal |
| Cabeçalho | ntifs.h (inclua Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Confira também
FsRtlGetPerStreamContextPointer