Função FltGetSectionContext (fltkernel.h)
A rotina FltGetSectionContext recupera um contexto de seção 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 por chamador que recebe o endereço do contexto. Esse parâmetro é necessário e não pode ser definido como NULL.
Valor de retorno
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, FltMgr definir 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. |
Observações
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 ao qual o parâmetro Context aponta. Quando esse ponteiro de contexto não for mais necessário, o chamador deverá 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 |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | FltMgr.lib |
| de DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |