GetFileBandwidthReservation 함수(winbase.h)

지정된 파일이 상주하는 볼륨의 대역폭 예약 속성을 검색합니다.

구문

BOOL GetFileBandwidthReservation(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpPeriodMilliseconds,
  [out] LPDWORD lpBytesPerPeriod,
  [out] LPBOOL  pDiscardable,
  [out] LPDWORD lpTransferSize,
  [out] LPDWORD lpNumOutstandingRequests
);

매개 변수

[in] hFile

파일에 대한 핸들입니다.

[out] lpPeriodMilliseconds

예약 기간을 수신하는 변수에 대한 포인터(밀리초)입니다. 기간은 I/O가 완료될 때까지 I/O가 커널에 발급되는 시간입니다. 이 핸들에 대해 예약된 대역폭이 없는 경우 반환되는 값은 이 볼륨에 대해 지원되는 최소 예약 기간입니다.

[out] lpBytesPerPeriod

볼륨에 예약할 수 있는 기간당 최대 바이트 수를 수신하는 변수에 대한 포인터입니다. 이 핸들에 대해 예약된 대역폭이 없는 경우 반환되는 값은 볼륨에 대해 지원되는 기간당 최대 바이트 수입니다.

[out] pDiscardable

TRUE 이면 기간이 만료되기 전에 드라이버가 I/O 작업을 충족할 수 없는 경우 오류와 함께 I/O를 완료해야 합니다. 기본 하위 시스템이 이러한 방식으로 실패를 지원하지 않는 경우 FALSE입니다.

[out] lpTransferSize

애플리케이션에서 발급할 수 있는 개별 I/O 요청의 최소 크기입니다. 모든 I/O 요청은 TransferSize의 배수여야 합니다. 이 핸들에 대해 예약된 대역폭이 없는 경우 반환되는 값은 이 볼륨에 대해 지원되는 최소 전송 크기입니다.

[out] lpNumOutstandingRequests

운영 체제에서 처리할 수 있는 TransferSize 청크의 수입니다.

반환 값

성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.

확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

기술	지원됨
SMB(서버 메시지 블록) 3.0 프로토콜	No
SMB 3.0 TFO(투명 장애 조치(failover))	No
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0	No
CsvFS(클러스터 공유 볼륨 파일 시스템)	No
ReFS(Resilient File System)	Yes

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

파일 관리 함수

SetFileBandwidthReservation