Função FltGetVolumeContext (fltkernel.h)
A rotina FltGetVolumeContext recupera um contexto que foi definido para um volume por um determinado driver de minifiltro.
Sintaxe
NTSTATUS FLTAPI FltGetVolumeContext(
[in] PFLT_FILTER Filter,
[in] PFLT_VOLUME Volume,
[out] PFLT_CONTEXT *Context
);
Parâmetros
[in] Filter
Ponteiro de filtro opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.
[in] Volume
Ponteiro opaco para o volume cujo contexto está sendo recuperado. Esse parâmetro é necessário e não pode ser NULL.
[out] Context
Ponteiro para uma variável alocada por chamador que recebe o endereço do contexto solicitado. Esse parâmetro é necessário e não pode ser definido como NULL.
Valor de retorno
FltGetVolumeContext retorna STATUS_SUCCESS quando retorna com êxito o contexto solicitado. Caso contrário, ele retornará um valor NTSTATUS apropriado, como o seguinte:
| 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. |
Observações
Para obter mais informações sobre contextos, consulte Sobre contextos de minifiltro.
FltGetVolumeContext incrementa a contagem de referência no contexto ao qual o parâmetro de Contexto 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 FltGetVolumeContext deve ser correspondida por uma chamada subsequente para FltReleaseContext.
Para definir um contexto para um volume, chame FltSetVolumeContext.
Para alocar um novo contexto, chame FltAllocateContext.
Para excluir um contexto de volume, chame FltDeleteVolumeContext ou FltDeleteContext.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | FltMgr.lib |
| de DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |