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 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 |
|---|---|
|
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 |