Função FltDeleteInstanceContext (fltkernel.h)
FltDeleteInstanceContext remove um contexto de uma determinada instância e marca o contexto para exclusão.
Sintaxe
NTSTATUS FLTAPI FltDeleteInstanceContext(
[in] PFLT_INSTANCE Instance,
[out] PFLT_CONTEXT *OldContext
);
Parâmetros
[in] Instance
Ponteiro de instância opaco para a instância.
[out] OldContext
Ponteiro para uma variável alocada pelo chamador que recebe o endereço do contexto excluído. Esse parâmetro é opcional e pode ser NULL. Se OldContext não for NULL e não apontar para NULL_CONTEXT, o chamador será responsável por chamar FltReleaseContext para liberar esse contexto quando ele não for mais necessário.
Retornar valor
FltDeleteInstanceContext retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:
Código de retorno | Descrição |
---|---|
STATUS_FLT_DELETING_OBJECT | A Instância especificada está sendo interrompida. Este é um código de erro. |
STATUS_NOT_FOUND | Nenhum contexto correspondente foi encontrado. Este é um código de erro. |
Comentários
Para obter mais informações sobre contextos, consulte Sobre contextos de minifiltro.
Como os contextos são contados por referência, geralmente não é necessário que um driver de minifiltro chame uma rotina como FltDeleteInstanceContext para excluir explicitamente um contexto.
Um driver de minifiltro chama FltDeleteInstanceContext para remover um contexto de uma instância e marcar o contexto para exclusão. O contexto geralmente é liberado imediatamente, a menos que haja uma referência pendente nele (por exemplo, porque o contexto ainda está sendo usado por outro thread).
Para alocar um novo contexto, chame FltAllocateContext.
Para obter um contexto de instância, chame FltGetInstanceContext.
Para definir um contexto de instância, chame FltSetInstanceContext.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Universal |
Cabeçalho | fltkernel.h (inclua Fltkernel.h) |
Biblioteca | FltMgr.lib |
IRQL | <= APC_LEVEL |