IDiscMaster::EnumDiscRecorders 메서드(imapi.h)
활성 디스크 master 형식에서 지원하는 모든 디스크 레코더에 대한 열거자를 검색합니다.
구문
HRESULT EnumDiscRecorders(
[out] IEnumDiscRecorders **ppEnum
);
매개 변수
[out] ppEnum
IEnumDiscRecorders 열거자에 대한 포인터의 주소입니다.
반환 값
S_OK 성공하면 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.
설명
IEnumDiscRecorders 는 IEnumXXXX에 설명된 대로 표준 COM 열거자입니다. Next를 호출할 때마다 IDiscRecorder에 대한 포인터 배열이 반환됩니다. 각 레코더 인터페이스는 기본 실제 디스크 레코더와 이미 연결된 사용 가능한 단일 레코더를 나타냅니다.
플러그 앤 플레이 도착 또는 출발 또는 SetActiveDiscMasterFormat 호출로 인해 사용 가능한 레코더 목록이 변경 될 수 있습니다. 애플리케이션은 IDiscMasterProgressEvents::NotifyPnPActivity에 대한 호출을 받으면 이러한 변경 내용에 대해 알림을 받습니다. 각 열거자에는 열거 시 지원되는 디바이스의 스냅샷 포함되어 있으므로 변경이 발생하면 애플리케이션에서 이 메서드를 다시 호출하여 새 열거자를 검색해야 합니다.
디바이스가 제거되면 기본 물리적 디바이스가 없는 경우에도 포인터 및 IDiscRecorder 인터페이스가 유효한 상태로 유지되어야 합니다. 이 경우 IDiscRecorder 또는 디스크 기록 요청에 대한 작업이 IMAPI_E_DEVICE_NOTPRESENT 반환할 수 있습니다.
MaxWriteSpeed 속성은 이 메서드가 호출될 때 업데이트됩니다. 기본 설정은 사용 가능한 가장 높은 쓰기 속도입니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | imapi.h |
| 라이브러리 | Uuid.lib |
| DLL | Actxprxy.dll |