Função FltEnumerateVolumes (fltkernel.h)

A rotina FltEnumerateVolumes enumera todos os volumes no sistema.

Sintaxe

NTSTATUS FLTAPI FltEnumerateVolumes(
  [in]  PFLT_FILTER Filter,
  [out] PFLT_VOLUME *VolumeList,
  [in]  ULONG       VolumeListSize,
  [out] PULONG      NumberVolumesReturned
);

Parâmetros

[in] Filter

Ponteiro de filtro opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.

[out] VolumeList

Ponteiro para um buffer alocado pelo chamador que recebe uma matriz de ponteiros de volume opaco. Esse parâmetro é opcional e pode ser NULL se VolumeListSize for zero. Se VolumeListSize for zero na entrada e VolumeList for NULL, NumberVolumesReturned receberá o número de volumes encontrados.

[in] VolumeListSize

Número de ponteiros de filtro opacos que o buffer para o qual o VolumeList aponta pode conter. Esse parâmetro é opcional e pode ser zero. Se VolumeListSize for zero na entrada e VolumeList for NULL, NumberVolumesReturned receberá o número de volumes encontrados.

[out] NumberVolumesReturned

Ponteiro para uma variável alocada pelo chamador que recebe o número de ponteiros de volume opaco retornados na matriz para a qual o VolumeList aponta. Se VolumeListSize for muito pequeno e VolumeList não for NULL na entrada, FltEnumerateVolumes retornará STATUS_BUFFER_TOO_SMALL e definirá NumberVolumesReturned para apontar para o número de volumes encontrados. Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

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

Código de retorno	Descrição
STATUS_BUFFER_TOO_SMALL	O buffer para o qual o parâmetro VolumeList aponta não é grande o suficiente para armazenar as informações solicitadas. Este é um código de erro.

Comentários

Como o conteúdo da lista de volumes do gerenciador de filtros pode ser alterado a qualquer momento, não há garantia de que duas chamadas para FltEnumerateVolumes retornem o mesmo resultado.

FltEnumerateVolumes adiciona uma referência de rundown a cada um dos ponteiros de volume opaco retornados na matriz para a qual o VolumeList aponta. Quando esses ponteiros não forem mais necessários, o chamador deverá liberá-los chamando FltObjectDereference em cada um deles. Portanto, cada chamada bem-sucedida para FltEnumerateVolumes deve ser correspondida por uma chamada subsequente a FltObjectDereference para cada ponteiro de volume retornado.

Para converter um ou mais ponteiros de volume opacos retornados pelo parâmetro VolumeList em informações de volume, chame FltGetVolumeInformation.

Para listar informações de volume para todos os volumes conhecidos pelo gerenciador de filtros, chame FltEnumerateVolumeInformation.

Para enumerar todos os drivers de minifiltro registrados, chame FltEnumerateFilters.

Para enumerar todas as instâncias do driver de minifiltro, chame FltEnumerateInstances.

Para enumerar todas as instâncias de driver de minifiltro em um determinado volume, chame FltEnumerateInstanceInformationByVolume.

Requisitos

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

Confira também

FltEnumerateFilters

FltEnumerateInstanceInformationByVolume

FltEnumerateInstances

FltEnumerateVolumeInformation

FltGetVolumeInformation

FltObjectDereference