IFileSystemImage::get_StageFiles 메서드(imapi2fs.h)

굽기 전에 파일 시스템 이미지에 추가되는 파일을 준비해야 하는지를 나타냅니다.

구문

HRESULT get_StageFiles(
  [out] VARIANT_BOOL *pVal
);

매개 변수

[out] pVal

VARIANT_TRUE 파일 시스템 이미지에 추가되는 파일이 굽기 전에 하나 이상의 스테이지 파일에서 준비되어야 하는 경우입니다. 그렇지 않으면 IMAPI 가 파일 시스템 이미지에 추가되는 파일을 준비하지 않음으로써 이미지 만들기 프로세스를 최적화할 수 있는 경우 VARIANT_FALSE 반환됩니다.

반환 값

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

반환 코드	설명
E_POINTER	포인터가 잘못되었습니다. 값: 0x80004003

설명

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

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

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

• 이미지 생성에 필요한 시간이 줄어듭니다.
• IMAPI를 통해 로컬 디스크에서 사용되는 공간 감소

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

요구 사항

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

추가 정보

IFileSystemImage

IFileSystemImage::p ut_StageFiles