Función FltGetVolumeFromInstance (fltkernel.h)
La rutina FltGetVolumeFromInstance devuelve un puntero opaco para el volumen al que está asociada una instancia de controlador de minifiltro determinada.
Sintaxis
NTSTATUS FLTAPI FltGetVolumeFromInstance(
[in] PFLT_INSTANCE Instance,
[out] PFLT_VOLUME *RetVolume
);
Parámetros
[in] Instance
Puntero de instancia opaco para la instancia.
[out] RetVolume
Puntero a una variable asignada por el autor de la llamada que recibe un puntero opaco para el volumen. Este parámetro es obligatorio y no puede ser NULL.
Valor devuelto
FltGetVolumeFromInstance devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente:
| Código devuelto | Descripción |
|---|---|
|
El volumen al que se adjunta la instancia del controlador de minifiltro se está descomponendo. Se trata de un código de error. |
Comentarios
FltGetVolumeFromInstance agrega una referencia de rundown al puntero de volumen opaco devuelto en el parámetro RetVolume . Cuando este puntero ya no es necesario, el autor de la llamada debe liberarlo llamando a FltObjectDereference. Por lo tanto, cada llamada correcta a FltGetVolumeFromInstance debe coincidir con una llamada posterior a FltObjectDereference.
Para obtener un puntero de filtro opaco para el controlador de minifiltro que creó una instancia determinada, llame a FltGetFilterFromInstance.
Para obtener un puntero al objeto de dispositivo de un volumen determinado, llame a FltGetDeviceObject.
Para obtener información detallada sobre el volumen al que está asociada una instancia determinada, llame a FltQueryVolumeInformation.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | fltkernel.h (incluya Fltkernel.h) |
| Library | FltMgr.lib |
| Archivo DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |