IFileSystemImage::p ut_StageFiles 메서드(imapi2fs.h)

파일 시스템 이미지에 추가되는 파일을 굽기 전에 스테이징해야 하는지 여부를 결정합니다.

구문

HRESULT put_StageFiles(
  [in] VARIANT_BOOL newVal
);

매개 변수

[in] newVal

파일 시스템 이미지에 추가된 파일이 굽기 전에 하나 이상의 스테이지 파일에서 스테이징되도록 강제하려면 VARIANT_TRUE 로 설정합니다. 그렇지 않으면 스테이징이 필요하지 않고 더 높은 성능이 필요한 경우 를 VARIANT_FALSE 로 설정합니다.

반환 값

S_OK 성공에 따라 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 오류 값만 나타내지 않습니다.

반환 코드	설명
E_NOTIMPL	구현되지 않았습니다. 값: 0x80004001

설명

"스테이징"은 화상 작업을 시작하기 전에 구울 모든 파일을 포함하는 이미지를 하드 드라이브에 만드는 프로세스입니다.

이 속성을 VARIANT_TRUE 설정하면 속성이 설정된 후에 추가되는 파일에만 영향을 미칩니다. 해당 파일은 항상 스테이징됩니다. 지정된 속성 값 VARIANT_TRUE 이전에 스테이징되지 않은 파일은 스테이징되지 않습니다.

VARIANT_FALSE 지정하면 파일 시스템 이미지 만들기 프로세스가 두 가지 방법으로 최적화됩니다.

• 이미지 생성에 필요한 시간 감소
• IMAPI를 통해 로컬 디스크에서 더 적은 공간 사용

그러나 버퍼가 굽는 동안 버퍼 언더런 문제를 방지하려면 스테이징되지 않은 파일에 대한 읽기 작업에는 특정 최소 처리량이 필요합니다. 파일 접근성 또는 처리량이 버너의 요구 사항을 충족하지 못할 경우 IMAPI는 지정된 속성 값에 관계없이 파일 스테이징을 적용합니다. 예를 들어 파일 스테이징은 USB 플래시 디스크와 같은 이동식 스토리지 디바이스의 원본 파일에 적용됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	imapi2fs.h

추가 정보

IFileSystemImage

IFileSystemImage::get_StageFiles