Macro FsRtlSetupAdvancedHeaderEx (ntifs.h)

Artigo
12/22/2024

A macro FsRtlSetupAdvancedHeaderEx é usada por sistemas de arquivos para inicializar uma estrutura FSRTL_ADVANCED_FCB_HEADER para uso com contextos de fluxo e de arquivo.

Sintaxe

void FsRtlSetupAdvancedHeaderEx(
   _advhdr,
   _fmutx,
   _fctxptr
);

Parâmetros

_advhdr

Ponteiro para a estrutura FSRTL_ADVANCED_FCB_HEADER a ser inicializada.

_fmutx

Ponteiro para um mutex rápido inicializado que será usado para sincronizar o acesso a determinados membros FSRTL_ADVANCED_FCB_HEADER. O mutex rápido deve ser alocado do pool nãopagado. Esse parâmetro é opcional e pode ser NULL. Os chamadores devem definir esse parâmetro para NULL se eles pretendem usar um objeto mutex rápido já existente. Se FastMutex for NULL, o chamador deverá definir explicitamente o membro FastMutex da estrutura FSRTL_ADVANCED_FCB_HEADER, contido no objeto de contexto de fluxo, para apontar para o mutex rápido existente. (Isso pode ser feito antes ou depois de chamar FsRtlSetupAdvancedHeaderEx.)

_fctxptr

Um ponteiro para um campo de ponteiro usado pela FSRTL (biblioteca de runtime do sistema de arquivos) para acompanhar contextos de arquivo. Esse parâmetro é opcional e pode ser NULL. Em particular:

Para sistemas operacionais Microsoft Windows lançados antes do Windows Vista, os chamadores devem definir esse parâmetro como NULL.
Para sistemas operacionais Windows começando com o Windows Vista: se FileContextSupportPointer não for NULL, FileContextSupportPointer deverá ser um ponteiro para uma variável PVOID dentro de uma estrutura por arquivo para o sistema de arquivos que criou a estrutura. Para indicar que o driver do sistema de arquivos não dá suporte a contextos de arquivo, os chamadores devem definir FileContextSupportPointer para NULL.

Valor de retorno

Nenhum

Observações

Os sistemas de arquivos usam a macro FsRtlSetupAdvancedHeaderEx para inicializar uma estrutura FSRTL_ADVANCED_FCB_HEADER para uso com contextos de fluxo e arquivo.

Quando a estrutura de cabeçalho fcb avançada não é mais necessária, o sistema de arquivos deve chamar FsRtlTeardownPerStreamContexts para liberar todas as estruturas de contexto de arquivo e fluxo associados.

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 para o Microsoft Windows 2000 Service Pack 4 (SP4); Windows XP
da Plataforma de Destino	Área de trabalho
cabeçalho	ntifs.h (inclua Ntifs.h, Fltkernel.h)
IRQL	PASSIVE_LEVEL

Consulte também

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer

FsRtlInitPerStreamContext

FsRtlInsertPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts

Compartilhar via