estrutura FLT_RELATED_CONTEXTS_EX (fltkernel.h)

Artigo
02/29/2024

A estrutura FLT_RELATED_CONTEXTS_EX contém os contextos de um driver de minifiltro para os objetos associados a uma operação de E/S. Essa estrutura estende a estrutura FLT_RELATED_CONTEXTS para incluir o contexto da seção.

Sintaxe

typedef struct _FLT_RELATED_CONTEXTS_EX {
  PFLT_CONTEXT VolumeContext;
  PFLT_CONTEXT InstanceContext;
  PFLT_CONTEXT FileContext;
  PFLT_CONTEXT StreamContext;
  PFLT_CONTEXT StreamHandleContext;
  PFLT_CONTEXT TransactionContext;
  PFLT_CONTEXT SectionContext;
} FLT_RELATED_CONTEXTS_EX, *PFLT_RELATED_CONTEXTS_EX;

Membros

VolumeContext

Ponteiro opaco para o contexto do minifiltro para o volume para o qual o membro Volume da estrutura FLT_RELATED_OBJECTS aponta.

InstanceContext

Ponteiro opaco para o contexto do driver de minifiltro para a instância para a qual o membro instance da estrutura FLT_RELATED_OBJECTS aponta.

FileContext

Um ponteiro opaco para o contexto por arquivo do driver de minifiltro para o identificador de fluxo para o qual o membro FileObject da estrutura FLT_RELATED_OBJECTS aponta.

StreamContext

Ponteiro opaco para o contexto de fluxo do minifiltro para o identificador de fluxo para o qual o membro FileObject da estrutura FLT_RELATED_OBJECTS aponta.

StreamHandleContext

Ponteiro opaco para o contexto do identificador de fluxo do minifiltro para o identificador de fluxo para o qual o membro FileObject da estrutura FLT_RELATED_OBJECTS aponta.

TransactionContext

Um ponteiro opaco para o contexto de transação do minifiltro para a transação para a qual o membro Transaction da estrutura FLT_RELATED_OBJECTS aponta.

SectionContext

Um ponteiro opaco para o contexto de seção do minifiltro para o identificador de fluxo para o qual o membro FileObject da estrutura FLT_RELATED_OBJECTS aponta.

Comentários

A estrutura FLT_RELATED_CONTEXTS_EX contém os contextos de um driver de minifiltro para os objetos associados a uma operação de E/S ou uma operação de instalação ou de desobstrução de instância.

Um driver de minifiltro usa a estrutura FLT_RELATED_CONTEXTS_EX para recuperar vários contextos para uma determinada operação. Para fazer isso, o driver de minifiltro aloca uma estrutura de FLT_RELATED_CONTEXTS_EX vazia e passa um ponteiro para ela como o parâmetro Contexts para FltGetContextsEx.

Um minifiltro também pode usar essa estrutura para liberar vários contextos para uma determinada operação. Para fazer isso, o driver de minifiltro passa um ponteiro para FLT_RELATED_CONTEXTS_EX como o parâmetro Contexts para FltReleaseContextsEx.

Para obter mais informações sobre como usar contextos, consulte a entrada de referência para FltAllocateContext.