Macro FsRtlSetupAdvancedHeaderEx (ntifs.h)

Artigo
03/08/2023

A macro FsRtlSetupAdvancedHeaderEx é usada por sistemas de arquivos para inicializar uma estrutura de 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 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 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. Especialmente:

Para sistemas operacionais Microsoft Windows lançados antes do Windows Vista, os chamadores devem definir esse parâmetro como NULL.
Para sistemas operacionais Windows que começam 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 como NULL.

Retornar valor

Nenhum

Comentários

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 associadas.

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