FltSetVolumeInformation 함수(fltkernel.h)

아티클
08/07/2023

FltSetVolumeInformation은 지정된 instance 연결된 볼륨에 대한 다양한 종류의 정보를 변경합니다.

구문

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

매개 변수

[in] Instance

볼륨에 연결된 미니필터 드라이버 instance 대한 불투명 instance 포인터입니다.

[out] Iosb

최종 완료 상태 수신하는 IO_STATUS_BLOCK 구조체 및 작업에 대한 정보를 가리키는 포인터입니다.

[out] FsInformation

볼륨에 대해 설정할 값을 포함하는 호출자가 할당한 버퍼에 대한 포인터입니다. 버퍼에 포함된 정보의 구조는 FsInformationClass 매개 변수에 의해 정의됩니다.

[in] Length

FsInformation이 가리키는 버퍼의 크기(바이트)입니다. 호출자는 지정된 FsInformationClass에 따라 이 매개 변수를 설정해야 합니다. 예를 들어 FsInformationClass 값이 FileFsControlInformation인 경우 Length 는 sizeof(FILE_FS_CONTROL_INFORMATION) 이상이어야 합니다.

[in] FsInformationClass

볼륨에 대해 설정할 정보 유형입니다. 다음 중 하나입니다.

값	의미
FileFsControlInformation	볼륨에 대한 FILE_FS_CONTROL_INFORMATION 설정합니다.
FileFsLabelInformation	볼륨에 대한 FILE_FS_LABEL_INFORMATION 설정합니다.
FileFsObjectIdInformation	볼륨에 대한 FILE_FS_OBJECTID_INFORMATION 설정합니다.

반환 값

FltSetVolumeInformation 은 STATUS_SUCCESS 또는 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

반환 코드	설명
STATUS_INFO_LENGTH_MISMATCH	Length에 잘못된 값이 지정되었습니다. 오류 코드입니다.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation 에서 풀 할당 오류가 발생했습니다. 오류 코드입니다.
STATUS_INVALID_INFO_CLASS	FsInformationClass에 잘못된 값이 지정되었습니다. 오류 코드입니다.
STATUS_INVALID_PARAMETER	인스턴스가 네트워크 볼륨에 연결됩니다. FltSetVolumeInformation을 사용하여 네트워크 볼륨 정보를 설정할 수 없습니다. 오류 코드입니다.