Função FltGetVolumeFromInstance (fltkernel.h)

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 por chamador que recebe um ponteiro opaco para o volume. Esse parâmetro é necessário e não pode ser NULL.

Valor de retorno

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

Observações

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

Consulte também

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation