다음을 통해 공유

IDiscFormat2Data::get_FreeSectorsOnMedia 메서드(imapi2.h)

  • 아티클

기존 데이터를 덮어쓰지 않고 증분 기록을 위해 디스크의 사용 가능한 섹터 수를 검색합니다.

참고 이 메서드가 DVD-/+RW, DVD-RAM 및 BD-RE 미디어에 대해 호출되면 보고된 무료 섹터 값 은 현재 사용 가능한 섹터 수가 아닌 총 용량을 나타냅니다. 이러한 미디어 형식에 대한 무료 섹터를 검색하려면 IFileSystemImage::ImportFileSystem 또는 IFileSystemImage::ImportSpecificFileSystem을 통해 파일 시스템을 가져와야 합니다. 그러면 IFileSystemImage::get_FreeMediaBlocks 메서드를 사용하여 값을 검색할 수 있습니다.

 

구문

HRESULT get_FreeSectorsOnMedia(
  [out] LONG *value
);

매개 변수

[out] value

디바이스의 미디어에서 사용 가능한 섹터 수입니다.

반환 값

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

반환 코드 설명
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.

값: 0x80070057
E_POINTER
 포인터가 잘못되었습니다.

값: 0x80004003
E_FAIL
 지정되지 않은 오류입니다.

값: 0x80004005
E_OUTOFMEMORY
 필요한 메모리를 할당하지 못했습니다.

값: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT
 디바이스가 시간 제한 기간 내에 명령을 수락하지 못했습니다. 이는 디바이스가 일관되지 않은 상태를 입력했거나 명령에 대한 시간 제한 값을 늘려야 할 수 있으므로 발생할 수 있습니다.

값: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE
 디바이스가 명령에 대해 예기치 않거나 잘못된 데이터를 보고했습니다.

값: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN
 미디어가 거꾸로 삽입됩니다.

값: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY
 드라이브가 준비 중이라고 보고했습니다. 나중에 요청을 다시 시도하세요.

값: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA
 디바이스에 미디어가 없습니다.

값: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS
 미디어 형식이 현재 지정되고 있습니다. 미디어 사용을 시도하기 전에 형식이 완료되기를 기다립니다.

값: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY
 드라이브는 쓰기 완료와 같은 장기 실행 작업을 수행하고 있다고 보고했습니다. 오랜 시간 동안 드라이브를 사용할 수 없습니다.

값: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING
 드라이브가 쓰기를 계속할 수 있을 만큼 빠르게 데이터를 받지 못했기 때문에 쓰기가 실패했습니다. 원본 데이터를 로컬 컴퓨터로 이동하거나, 쓰기 속도를 줄이거나, "버퍼 언더런 무료" 설정을 사용하도록 설정하면 이 문제가 resolve 수 있습니다.

값: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE
 미디어가 호환되지 않거나 알 수 없는 물리적 형식입니다.

값: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT
 DVD 구조가 없습니다. 이는 호환되지 않는 드라이브/매체 사용으로 인해 발생할 수 있습니다.

값: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE
 디바이스에서 요청된 모드 페이지(및 형식)가 없다고 보고했습니다.

값: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS
 드라이브는 MODE SELECT 명령에 대한 모드 페이지에 제공된 매개 변수의 조합이 지원되지 않는다고 보고했습니다.

값: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED
 드라이브는 미디어가 쓰기 보호되었다고 보고했습니다.

값: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH
 미디어의 속도는 디바이스와 호환되지 않습니다. 이는 디바이스에서 지원하는 속도 범위보다 높거나 낮은 속도 미디어를 사용하여 발생할 수 있습니다.

값: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
 지정한 핸들이 잘못되었습니다.

값: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
 지정된 네트워크 리소스 또는 디바이스를 더 이상 사용할 수 없습니다.

값: 55
E_IMAPI_RECORDER_LOCKED
 마지막 작업 중에 이 레코더와 연결된 디바이스가 단독으로 잠겨 이 작업이 실패했습니다.

값: 0xC0AA0210
E_IMAPI_DF2DATA_INVALID_MEDIA_STATE
 요청된 작업은 지원되는 미디어에서만 유효합니다.

값: 0xC0AA0402

설명

이 속성의 값은 쓰기 작업에 디스크에서 사용할 수 있는 섹터의 수입니다. 값은 런아웃 블록 및 사후 갭과 같은 디스크 공간 및 데이터 품질을 관리하는 데 사용되는 섹터를 필터링합니다.

참고 실제 세션이 하나만 있는 덮어쓸 수 있는 디스크의 경우 값 으로 표시된 무료 섹터의 수는 항상 디스크의 총 섹터 수입니다.
 
IDiscFormat2Data::p ut_ForceOverwrite가 VARIANT_TRUE 설정된 경우 대신 IDiscFormat2Data::get_TotalSectorsOnMedia 속성을 사용합니다.

요구 사항

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

참고 항목

IDiscFormat2Data

IDiscFormat2Data::get_TotalSectorsOnMedia