estrutura FLT_RELATED_CONTEXTS (fltkernel.h)

Artigo
02/26/2024

A estrutura FLT_RELATED_CONTEXTS contém contextos de um driver de minifiltro para os objetos associados a uma operação de E/S.

Sintaxe

typedef struct _FLT_RELATED_CONTEXTS {
  PFLT_CONTEXT VolumeContext;
  PFLT_CONTEXT InstanceContext;
  PFLT_CONTEXT FileContext;
  PFLT_CONTEXT StreamContext;
  PFLT_CONTEXT StreamHandleContext;
  PFLT_CONTEXT TransactionContext;
} FLT_RELATED_CONTEXTS, *PFLT_RELATED_CONTEXTS;

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

No Windows Vista e posterior, esse membro é 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. Em sistemas operacionais Windows anteriores ao Windows Vista, esse membro é reservado para uso do sistema.

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

No Windows Vista e posterior, esse membro é 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. Em sistemas operacionais Windows anteriores ao Windows Vista, esse membro é reservado para uso do sistema.

Comentários

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

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

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 como o parâmetro Contexts para FltReleaseContexts.

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