Função FltGetSectionContext (fltkernel.h)
A rotina FltGetSectionContext recupera um contexto de seção que foi criado para um fluxo de arquivos por uma instância de driver de minifiltro especificada.
Sintaxe
NTSTATUS FLTAPI FltGetSectionContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Parâmetros
[in] Instance
Um ponteiro de instância opaco para a instância do driver de minifiltro cujo contexto deve ser recuperado.
[in] FileObject
Um ponteiro para um objeto de arquivo para o fluxo.
[out] Context
Um ponteiro para uma variável alocada pelo chamador que recebe o endereço do contexto. Esse parâmetro é necessário e não pode ser definido como NULL.
Retornar valor
FltGetSectionContext retorna STATUS_SUCCESS quando retorna com êxito o contexto de seção solicitado. Caso contrário, ele retornará um valor NTSTATUS apropriado, como um dos seguintes:
| Código de retorno | Descrição |
|---|---|
| STATUS_NOT_FOUND | Nenhum contexto correspondente foi encontrado neste arquivo no momento, portanto, o FltMgr definiu Context como NULL_CONTEXT. Este é um código de erro. |
| STATUS_NOT_SUPPORTED | O volume anexado a essa instância não dá suporte a contextos de seção. Este é um código de erro. |
Comentários
Para obter mais informações sobre contextos, consulte Sobre contextos de minifiltro.
FltGetSectionContext recupera um contexto de seção que foi criado para um fluxo de arquivos por uma instância de driver de minifiltro especificada. Um contexto de seção é criado chamando FltCreateSectionForDataScan.
FltGetSectionContext incrementa a contagem de referência no contexto para o qual o parâmetro Context aponta. Quando esse ponteiro de contexto não é mais necessário, o chamador deve diminuir sua contagem de referência chamando FltReleaseContext. Portanto, cada chamada bem-sucedida para FltGetSectionContext deve ser correspondida por uma chamada subsequente para FltReleaseContext.
Para alocar um novo contexto, chame FltAllocateContext.
Os minifiltros não devem excluir explicitamente um contexto de seção passado para FltCreateSectionForDataScan. Um contexto de seção é desalocado e removido de um fluxo chamando FltCloseSectionForDataScan nesse caso.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Plataforma de Destino | Universal |
| Cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| Biblioteca | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |