Macro FsRtlGetPerStreamContextPointer (ntifs.h)

Artigo
03/01/2024

A macro FsRtlGetPerStreamContextPointer retorna o contexto de fluxo do sistema de arquivos para um fluxo de arquivos.

Sintaxe

void FsRtlGetPerStreamContextPointer(
   _fo
);

Parâmetros

_fo

Ponteiro para um objeto de arquivo para o fluxo de arquivos.

Retornar valor

Nenhum

Comentários

Os drivers de filtro do sistema de arquivos podem usar a macro FsRtlGetPerStreamContextPointer para obter um ponteiro de contexto de fluxo para o fluxo de arquivos representado por um determinado objeto de arquivo. Um ponteiro de contexto de fluxo é um ponteiro para o contexto de fluxo do sistema de arquivos para o fluxo de arquivos. Esse ponteiro pode ser passado como um parâmetro para FsRtlInsertPerStreamContext, FsRtlLookupPerStreamContext e FsRtlRemovePerStreamContext.

O ponteiro de contexto de fluxo aponta para uma estrutura FSRTL_ADVANCED_FCB_HEADER que identifica exclusivamente o fluxo de arquivos para o sistema de arquivos. Essa estrutura geralmente é inserida em um objeto de contexto de fluxo, como um FCB (bloco de controle de arquivo) ou um SCB (bloco de controle de fluxo). Quando o fluxo de arquivos é aberto, o sistema de arquivos armazena um ponteiro para o FCB ou SCB no membro FsContext do objeto de arquivo.

Nota A macro FsRtlGetPerStreamContextPointer só pode ser usada em sistemas de arquivos que dão suporte a cabeçalhos FCB avançados.

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	Windows XP; Pacote cumulativo de atualizações do Windows 2000 SP4
Plataforma de Destino	Área de Trabalho
Cabeçalho	ntifs.h (inclua Ntifs.h)
IRQL	<= APC_LEVEL