Função FltGetStreamHandleContext (fltkernel.h)
A rotina FltGetStreamHandleContext recupera um contexto que foi definido para um identificador de fluxo por uma determinada instância de driver de minifiltro.
Sintaxe
NTSTATUS FLTAPI FltGetStreamHandleContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *Context
);
Parâmetros
[in] Instance
Ponteiro de instância opaco para a instância do driver de minifiltro cujo contexto deve ser recuperado.
[in] FileObject
Ponteiro para um objeto de arquivo para o identificador de fluxo.
[out] Context
Ponteiro para uma variável alocada pelo chamador que recebe o endereço do contexto. Esse parâmetro não pode ser definido como NULL.
Retornar valor
FltGetStreamHandleContext retorna STATUS_SUCCESS quando retorna com êxito o contexto 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 sistema de arquivos não dá suporte a contextos por fluxo para esse fluxo de arquivos. Este é um código de erro. |
Comentários
Para obter mais informações sobre contextos, consulte Sobre contextos de minifiltro.
FltGetStreamHandleContext recupera um contexto que foi definido para um identificador de fluxo por um determinado driver de minifiltro.
FltGetStreamHandleContext 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 FltGetStreamHandleContext deve ser correspondida por uma chamada subsequente para FltReleaseContext.
Para definir um contexto para um identificador de fluxo, chame FltSetStreamHandleContext
Para alocar um novo contexto, chame FltAllocateContext.
Para excluir um contexto de identificador de fluxo, chame FltDeleteStreamHandleContext ou FltDeleteContext.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Universal |
Cabeçalho | fltkernel.h (inclua Fltkernel.h) |
Biblioteca | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |