KsQueryInformationFile 함수(ks.h)

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

구문

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

매개 변수

[in] FileObject

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

[out] FileInformation

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

[in] Length

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

[in] FileInformationClass

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

반환 값

KsQueryInformationFile 함수는 성공하거나 실패하면 쿼리 오류를 반환하는 STATUS_SUCCESS 반환합니다.

설명

KsQueryInformationFile 함수는 쿼리로 인해 기본 드라이버에 대한 실제 요청이 발생하는 경우에만 사용해야 합니다. 예를 들어 FilePositionInformation 은 이러한 요청을 생성하지 않으며 사용하면 안 됩니다. 호출자가 FO_SYNCHRONOUS_IO 파일 개체에 대한 작업을 위해 파일에 대한 액세스를 직렬화하고 있다고 가정합니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	ks.h(Ks.h 포함)
라이브러리	Ks.lib