IDiscFormat2Erase::EraseMedia 메서드(imapi2.h)
활성 디스크 레코더의 미디어를 지웁니다.
구문
HRESULT EraseMedia();
반환 값
S_OK 성공하면 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.
| 반환 코드 | 설명 |
|---|---|
|
포인터가 잘못되었습니다.
값: 0x80004003 |
|
지정되지 않은 오류입니다.
값: 0x80004005 |
|
필요한 메모리를 할당하지 못했습니다.
값: 0x8007000E |
|
디바이스가 시간 제한 기간 내에 명령을 수락하지 못했습니다. 이는 디바이스가 일관되지 않은 상태를 입력했거나 명령에 대한 시간 제한 값을 늘려야 할 수 있으므로 발생할 수 있습니다.
값: 0xC0AA020D |
|
디바이스가 명령에 대해 예기치 않거나 잘못된 데이터를 보고했습니다.
값: 0xC0AA02FF |
|
미디어가 거꾸로 삽입됩니다.
값: 0xC0AA0204 |
|
드라이브가 준비 중이라고 보고했습니다. 나중에 요청을 다시 시도하세요.
값: 0xC0AA0205 |
|
디바이스에 미디어가 없습니다.
값: 0xC0AA0202 |
|
미디어 형식이 현재 지정되고 있습니다. 미디어를 사용하기 전에 형식이 완료되기를 기다립니다.
값: 0xC0AA0206 |
|
드라이브는 쓰기 완료와 같은 장기 실행 작업을 수행하고 있다고 보고했습니다. 오랫동안 드라이브를 사용할 수 없습니다.
값: 0xC0AA0207 |
|
드라이브가 쓰기를 계속할 만큼 신속하게 데이터를 받지 못했기 때문에 쓰기에 실패했습니다. 원본 데이터를 로컬 컴퓨터로 이동하거나, 쓰기 속도를 줄이거나, "버퍼 언더런 무료" 설정을 사용하도록 설정하면 이 문제가 resolve 수 있습니다.
값: 0xC0AA0300 |
|
미디어가 호환되지 않거나 알 수 없는 물리적 형식입니다.
값: 0xC0AA0203 |
|
DVD 구조가 없습니다. 이는 호환되지 않는 드라이브/매체 사용으로 인해 발생할 수 있습니다.
값: 0xC0AA020E |
|
디바이스에서 요청된 모드 페이지(및 유형)가 없다고 보고했습니다.
값: 0xC0AA0201 |
|
드라이브는 MODE SELECT 명령에 대한 모드 페이지에 제공된 매개 변수의 조합이 지원되지 않는다고 보고했습니다.
값: 0xC0AA0208 |
|
드라이브는 미디어가 쓰기 보호되어 있다고 보고했습니다.
값: 0xC0AA0209 |
|
미디어의 속도는 디바이스와 호환되지 않습니다. 이는 디바이스에서 지원하는 속도 범위보다 높거나 낮은 속도 미디어를 사용하여 발생할 수 있습니다.
값: 0xC0AA020F |
|
지정한 핸들이 잘못되었습니다.
값: 6 |
|
지정된 네트워크 리소스 또는 디바이스를 더 이상 사용할 수 없습니다.
값: 55 |
|
마지막 작업 중에 이 레코더와 연결된 디바이스가 단독으로 잠겨 이 작업이 실패했습니다.
값: 0xC0AA0210 |
|
현재 미디어 형식은 지원되지 않습니다.
값: 0xC0AA0909 |
|
드라이브가 START UNIT(스핀업) 명령에 대한 오류를 반환했습니다. 수동 개입이 필요할 수 있습니다.
값: 0x80AA0908 |
|
드라이브가 1시간 만에 지우기를 완료하지 못했습니다. 드라이브에 전원 주기, 미디어 제거 또는 기타 수동 개입이 필요할 수 있습니다.
참고 현재 이 값은 미디어가 잘못되어 IDiscFormat2Erase 인터페이스를 통해 CD-RW 또는 DVD-RW 미디어에서 지우기를 수행하려는 시도가 실패하는 경우에도 반환됩니다.
|
설명
미디어를 동기적으로 지웁니다. DDiscFormat2EraseEvents 형식의 등록된 이벤트로 를 호출하여 진행률을 보고할 수 있습니다.
이 메서드를 호출하기 전에 다음 메서드를 호출해야 합니다.
기본값이 애플리케이션에 적합하지 않은 경우 IDiscFormat2Erase::p ut_FullErase 메서드를 호출하는 것도 고려해야 합니다.이 메서드는 동기적이며, 지우기 작업의 진행률을 확인하려면 DDiscFormat2EraseEvents 인터페이스를 구현해야 합니다. 스크립트에서 이벤트 처리기를 구현하는 방법을 보여 주는 예제는 이벤트 로 진행률 모니터링을 참조하세요.
현재 미디어가 잘못되었거나 드라이브 오류가 발생하여 IDiscFormat2Erase 인터페이스를 통해 CD-RW 또는 DVD-RW 미디어에서 지우기를 수행하려는 시도가 실패하면 E_IMAPI_ERASE_TOOK_LONGER_THAN_ONE_HOUR 값이 반환됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | imapi2.h |