IDiscRecorder2Ex::GetModePage 메서드(imapi2.h)

디바이스에서 지정된 모드 페이지를 검색합니다.

구문

HRESULT GetModePage(
  [in]  IMAPI_MODE_PAGE_TYPE         requestedModePage,
  [in]  IMAPI_MODE_PAGE_REQUEST_TYPE requestType,
  [out] BYTE                         **modePageData,
  [out] ULONG_IMAPI2_MODE_PAGE       *byteSize
);

매개 변수

[in] requestedModePage

검색할 모드 페이지입니다. 가능한 값은 IMAPI_MODE_PAGE_TYPE 열거형 형식을 참조하세요.

[in] requestType

검색할 모드 페이지 데이터의 유형(예: 현재 설정 또는 쓰기가 설정된 설정). 가능한 값은 IMAPI_MODE_PAGE_REQUEST_TYPE 열거형 형식을 참조하세요.

[out] modePageData

모드 페이지를 포함하는 데이터 버퍼입니다. 데이터 버퍼의 내용에 대한 자세한 내용은 ftp://ftp.t10.org/t10/drafts/mmc5 MMC 사양의 최신 수정 버전에서 MODE SENSE(10) 명령을 참조하세요.

이 메서드는 버퍼를 반환하기 전에 헤더 정보 및 기타 페이지가 아닌 데이터를 제거합니다.

완료되면 CoTaskMemFree 함수를 호출하여 메모리를 해제합니다.

[out] byteSize

modePageData 데이터 버퍼의 크기(바이트)입니다.

반환 값

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
드라이브가 쓰기를 계속할 만큼 신속하게 데이터를 받지 못했기 때문에 쓰기가 실패했습니다. 원본 데이터를 로컬 컴퓨터로 이동하거나, 쓰기 속도를 줄이거나, "버퍼 언더런 무료" 설정을 사용하도록 설정하면 이 문제가 해결될 수 있습니다.

값: 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_RECORDER_NO_SUCH_MODE_PAGE
디바이스에서 요청된 모드 페이지(및 유형)가 없다고 보고했습니다.

값: 0xC0AA0201

요구 사항

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

추가 정보

IDiscRecorder2Ex

IDiscRecorder2Ex::GetSupportedModePages

IDiscRecorder2Ex::SetModePage

IMAPI_MODE_PAGE_REQUEST_TYPE

IMAPI_MODE_PAGE_TYPE