Função FsRtlInsertPerStreamContext (ntifs.h)
A rotina FsRtlInsertPerStreamContext
Sintaxe
NTSTATUS FsRtlInsertPerStreamContext(
PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
[in] PFSRTL_PER_STREAM_CONTEXT Ptr
);
Parâmetros
PerStreamContext
Ponteiro para a estrutura de FSRTL_ADVANCED_FCB_HEADER do fluxo de arquivos. Para obter esse ponteiro de um objeto de arquivo, use a macro
[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
Valor de retorno
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. |
Observações
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 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 |
Universal |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL |
NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Consulte também
FsRtlGetPerStreamContextPointer