Função FsRtlSetupAdvancedHeader (ntifs.h)

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

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

Valor de retorno

Nenhum

Observações

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 controle Per-Stream contexto em um driver de filtro do sistema de arquivos herdado.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP
da Plataforma de Destino	Área de trabalho
cabeçalho	ntifs.h (inclua Ntifs.h, Fltkernel.h)
IRQL	<= APC_LEVEL

Consulte também

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer

FsRtlInitPerStreamContext

FsRtlInsertPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts