Função FltGetVolumeFromInstance (fltkernel.h)

  • Artigo

A rotina FltGetVolumeFromInstance retorna um ponteiro opaco para o volume ao qual uma determinada instância de driver de minifiltro está anexada.

Sintaxe

NTSTATUS FLTAPI FltGetVolumeFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_VOLUME   *RetVolume
);

Parâmetros

[in] Instance

Ponteiro de instância opaco para a instância.

[out] RetVolume

Ponteiro para uma variável alocada pelo chamador que recebe um ponteiro opaco para o volume. Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

FltGetVolumeFromInstance retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno Descrição
STATUS_FLT_DELETING_OBJECT
 O volume ao qual a instância do driver de minifiltro está anexada está sendo dividido. Este é um código de erro.

Comentários

FltGetVolumeFromInstance adiciona uma referência de rundown ao ponteiro de volume opaco retornado no parâmetro RetVolume . Quando esse ponteiro não for mais necessário, o chamador deverá liberá-lo chamando FltObjectDereference. Portanto, cada chamada bem-sucedida para FltGetVolumeFromInstance deve ser correspondida por uma chamada subsequente para FltObjectDereference.

Para obter um ponteiro de filtro opaco para o driver de minifiltro que criou uma determinada instância, chame FltGetFilterFromInstance.

Para obter um ponteiro para o objeto do dispositivo para um determinado volume, chame FltGetDeviceObject.

Para obter informações detalhadas sobre o volume ao qual uma determinada instância está anexada, chame FltQueryVolumeInformation.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Confira também

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation