Macro FsRtlSetupAdvancedHeaderEx2 (ntifs.h)

Artigo
08/07/2023

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

Sintaxe

void FsRtlSetupAdvancedHeaderEx2(
   _advhdr,
   _fmutx,
   _fctxptr,
   _aepushlock
);

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 como NULL se pretenderem 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 FsRtlSetupAdvancedHeaderEx2.)

_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. 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 como NULL.

_aepushlock

Ponteiro para uma estrutura opaca usada para inicializar o campo AePushLock do cabeçalho avançado. O chamador dessa função é responsável por primeiro alocar e inicializar a memória para esse campo chamando FsRtlAllocateAePushLock e, posteriormente, liberando a memória chamando FsRtlFreeAePushLock. Consulte FSRTL_ADVANCED_FCB_HEADER para obter mais informações sobre bloqueios de push de expansão automática.

Retornar valor

Nenhum

Comentários

Os sistemas de arquivos usam a macro FsRtlSetupAdvancedHeaderEx2 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 associadas.

Para obter mais informações, consulte Acompanhamento Per-Stream contexto em um driver de filtro do sistema de arquivos herdado.