KsSetInformationFile 함수(ks.h)

KsSetInformationFile 함수는 지정된 파일 개체에 대해 정보 집합을 수행합니다. 함수는 가능한 경우 FastIoDispatch 를 사용하려고 시도하거나 디바이스 개체에 대한 정보 집합을 생성합니다.

구문

KSDDKAPI NTSTATUS KsSetInformationFile(
  [in] PFILE_OBJECT           FileObject,
  [in] PVOID                  FileInformation,
  [in] ULONG                  Length,
  [in] FILE_INFORMATION_CLASS FileInformationClass
);

매개 변수

[in] FileObject

표준 정보를 설정할 파일 개체를 지정합니다.

[in] FileInformation

파일 정보를 넣을 위치를 나타냅니다. 파일 정보는 유효하거나 프로브된 주소로 간주됩니다.

[in] Length

FileInformation 버퍼의 올바른 길이를 지정합니다.

[in] FileInformationClass

설정되는 정보의 클래스를 지정합니다.

반환 값

KsSetInformationFile 함수는 성공하거나 실패하면 설정된 오류를 반환하는 STATUS_SUCCESS 반환합니다.

설명

KsSetInformationFile 함수는 집합이 기본 드라이버에 대한 실제 요청이 발생하는 경우에만 사용해야 하며, 이름 바꾸기, 삭제 및 완료와 같이 드라이버에 추가 매개 변수를 보내야 하는 복잡한 작업은 포함하지 않습니다. 예를 들어 FilePositionInformation 은 이러한 요청을 생성하지 않으므로 사용하지 않아야 합니다. 호출자가 FO_SYNCHRONOUS_IO 파일 개체에 대한 작업을 위해 파일에 대한 액세스를 직렬화한다고 가정합니다.

요구 사항