Compartilhar via


Função FsRtlSetupAdvancedHeader (ntifs.h)

A macro FsRtlSetupAdvancedHeader é usada por sistemas de arquivos para inicializar uma estrutura FSRTL_ADVANCED_FCB_HEADER para uso com contextos de filtro.

Sintaxe

void FsRtlSetupAdvancedHeader(
  PVOID       AdvHdr,
  PFAST_MUTEX FMutex
);

Parâmetros

AdvHdr

Um ponteiro para a estrutura FSRTL_ADVANCED_FCB_HEADER a ser inicializada.

FMutex

Um ponteiro para um mutex rápido inicializado que será usado para sincronizar o acesso à estrutura FSRTL_ADVANCED_FCB_HEADER . O mutex rápido deve ser alocado do pool nãopagado.

Este parâmetro 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 do objeto de contexto de fluxo para apontar para o mutex rápido existente. (Isso pode ser feito antes ou depois de chamar FsRtlSetupAdvancedHeader.)

Retornar valor

Nenhum

Comentários

Os sistemas de arquivos usam a macro FsRtlSetupAdvancedHeader para inicializar uma estrutura FSRTL_ADVANCED_FCB_HEADER para uso com contextos de filtro.

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 por 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 Windows XP
Plataforma de Destino Área de Trabalho
Cabeçalho ntifs.h (inclua Ntifs.h, Fltkernel.h)
IRQL <= APC_LEVEL

Confira também

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer

FsRtlInitPerStreamContext

FsRtlInsertPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts