FltQueryVolumeInformationFile 함수(fltkernel.h)
FltQueryVolumeInformationFile 은 지정된 파일, 디렉터리, 스토리지 디바이스 또는 볼륨에 대한 볼륨 정보를 검색합니다.
구문
NTSTATUS FLTAPI FltQueryVolumeInformationFile(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PVOID FsInformation,
[in] ULONG Length,
[in] FS_INFORMATION_CLASS FsInformationClass,
[out, optional] PULONG LengthReturned
);
매개 변수
[in] Instance
호출자에 대한 불투명 instance 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
[in] FileObject
열려 있는 파일, 디렉터리, 스토리지 디바이스 또는 볼륨에 대한 파일 개체 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
[out] FsInformation
파일에 대한 정보를 수신하는 호출자가 할당한 버퍼에 대한 포인터입니다. FsInformationClass 매개 변수는 정보 유형을 지정합니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
[in] Length
FsInformation 버퍼의 크기(바이트)입니다.
[in] FsInformationClass
반환할 볼륨 정보의 유형입니다. 다음 중 하나
| 값 | 의미 |
|---|---|
|
볼륨을 담당하는 파일 시스템에 대한 특성 정보를 포함하는 FILE_FS_ATTRIBUTE_INFORMATION 구조를 반환합니다. |
|
볼륨에 대한 파일 시스템 제어 정보가 포함된 FILE_FS_CONTROL_INFORMATION 구조를 반환합니다. |
|
볼륨에 대한 디바이스 정보가 포함된 FILE_FS_DEVICE_INFORMATION 구조를 반환합니다. |
|
지정된 드라이버가 볼륨의 I /O 경로에 있는지 여부에 대한 정보가 포함된 FILE_FS_DRIVER_PATH_INFORMATION 구조를 반환합니다. 호출자는 FltQueryVolumeInformationFile을 호출하기 전에 드라이버의 이름을 FILE_FS_DRIVER_PATH_INFORMATION 구조에 저장해야 합니다. |
|
볼륨에서 사용할 수 있는 총 공간 양에 대한 정보를 포함하는 FILE_FS_FULL_SIZE_INFORMATION 구조를 반환합니다. |
|
볼륨에 대한 파일 시스템별 개체 ID 정보가 포함된 FILE_FS_OBJECTID_INFORMATION 구조를 반환합니다. 이는 운영 체제에서 할당한 (GUID 기반) 고유 볼륨 이름과는 다릅니다. |
|
호출 스레드와 연결된 사용자가 사용할 수 있는 볼륨의 공간 양에 대한 정보가 포함된 FILE_FS_SIZE_INFORMATION 구조를 반환합니다. |
|
볼륨 레이블, 일련 번호 및 생성 시간과 같은 볼륨에 대한 정보가 포함된 FILE_FS_VOLUME_INFORMATION 반환합니다. |
|
볼륨의 물리적 및 논리적 섹터 크기에 대한 정보를 포함하는 FILE_FS_SECTOR_SIZE_INFORMATION 구조를 반환합니다. |
[out, optional] LengthReturned
FsInformation 버퍼에 반환된 정보의 크기(바이트)를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
반환 값
FltQueryVolumeInformationFile 은 STATUS_SUCCESS 또는 다음과 같은 적절한 NTSTATUS 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
볼륨이 현재 탑재되지 않았습니다. 오류 코드입니다. |
설명
FltQueryVolumeInformationFile 은 지정된 파일, 디렉터리, 스토리지 디바이스 또는 볼륨에 대한 볼륨 정보를 검색합니다.
FileObject가 열려 있는 직접 디바이스를 나타내는 경우 FileFsDeviceInformation만 FsInformationClass 값으로 지정할 수 있습니다.
FltQueryVolumeInformationFile 은 특정 파일 시스템에서 지원하지 않는 FILE_FS_XXX_INFORMATION 구조체의 모든 멤버에서 0을 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | fltkernel.h(Fltkernel.h 포함) |
| 라이브러리 | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |
추가 정보
FILE_FS_DRIVER_PATH_INFORMATION
FILE_FS_SECTOR_SIZE_INFORMATION