개체(Windows Media 형식 11 SDK)

[이 페이지와 연결된 기능인 Windows Media Format 11 SDK는 레거시 기능입니다. 원본 판독기 및 싱크 작성기에 의해 대체되었습니다. 원본 판독기 및 싱크 작성기는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows Media Format 11 SDK 대신 소스 판독기 및 싱크 작성기를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

Windows Media Format SDK는 여러 개체를 사용하여 ASF 파일을 읽고, 쓰고, 편집하고, 인덱싱하고, 프로필을 만들고 편집합니다. 각 개체는 여러 인터페이스를 지원합니다. 일부 인터페이스는 여러 개체에서 지원됩니다. 이러한 경우 구현의 차이점은 인터페이스에 대한 참조 섹션에서 설명합니다.

Windows Media Format SDK의 개체는 COM 규격입니다. 개발을 더 쉽게 하기 위해 모든 개체에는 연결된 생성 함수 또는 메서드가 있습니다. COM 함수 CoCreateInstance를 수동으로 사용하는 대신 생성 함수 또는 메서드를 사용하여 개체를 만들어야 합니다.

일부 인터페이스에는 이름에 IWMProfile2IWMWriter3과 같은 번호가 추가되어 있습니다. 각 경우에 번호가 매겨진 버전은 이전 버전의 모든 메서드를 상속하고 새 기능을 추가합니다.

이 참조의 각 개체 페이지에서 기본 COM 개체에 포함된 인터페이스가 먼저 나열되고 애플리케이션에서 구현해야 하는 콜백 인터페이스가 나열됩니다.

다음 표에서는 각 SDK에서 지원하는 개체와 각 SDK의 기능에 대한 설명과 이를 만드는 데 사용되는 함수를 나열합니다.

개체 설명 만들기 함수
백업 복원기 일반적으로 이동식 미디어에 라이선스를 백업한 다음 해당 라이선스를 다른 컴퓨터로 복원합니다. WMCreateBackupRestorer
디바이스 등록 네트워크 연결을 통해 사용할 수 있는 미디어 재생 디바이스에 대한 항목이 포함된 디바이스 등록 데이터베이스를 관리합니다. WMCreateDeviceRegistration
DRM Transcryptor DRM으로 보호되는 미디어 데이터를 네트워크 디바이스 프로토콜용 Windows Media DRM 10을 사용하는 디바이스로 보낼 수 있는 데이터 스트림으로 변환합니다. WMCreateDRMTranscryptor
인덱서 비디오 스트림이 있는 파일에서 검색할 수 있도록 ASF 파일에 대한 인덱스를 만듭니다. WMCreateIndexer
라이선스 해지 에이전트 라이선스 해지를 관리합니다. WMCreateLicenseRevocationAgent
메타데이터 편집기 ASF 파일 헤더에서 메타데이터를 편집합니다. WMCreateEditor
프로필 관리자 프로필을 만들고, 로드하고, 저장할 수 있는 인터페이스를 제공합니다. ASF 파일을 작성하려면 프로필이 필요합니다. WMCreateProfileManager
판독기 ASF 파일을 읽습니다. 이 개체는 해당 작업에 비동기 호출 모델을 사용합니다. WMCreateReader
동기 판독기 동기 호출을 사용하여 ASF 파일을 읽습니다. WMCreateSyncReader
작가 ASF 파일을 씁니다. WMCreateWriter
기록기 파일 싱크 기록기 개체에서 작성한 ASF 파일을 제어합니다. WMCreateWriterFileSink
기록기 네트워크 싱크 기록기 개체에서 작성한 ASF 파일의 라이브 네트워크 스트리밍을 제어합니다. WMCreateWriterNetworkSink
기록기 푸시 싱크 스트리밍 콘텐츠를 게시 서버로 배달하도록 제어합니다. WMCreateWriterPushSink

다음 표에서는 다른 개체에 종속된 개체를 나열합니다. 이러한 개체는 기존 개체의 메서드에 의해 만들어집니다.

개체 설명 생성 방법
대역폭 공유 프로필의 대역폭 공유 정보를 관리합니다. 프로필에 대해 둘 이상의 대역폭 공유 개체가 있을 수 있습니다. 새 대역폭 공유 개체를 만들거나 기존 개체에 액세스할지 여부에 따라 대역폭 공유 개체를 만드는 방법에는 여러 가지가 있습니다. IWMProfile3::CreateNewBandwidthSharing또는
IWMProfile3::GetBandwidthSharing
Buffer 미디어 샘플 및 연결된 모든 데이터 단위 확장을 포함합니다. 샘플 작성 및 읽기 모두에 사용됩니다. IWMWriter::AllocateSample또는
IWMReaderAllocatorEx::AllocateForOutputEx
또는
IWMReaderAllocatorEx::AllocateForStreamEx
또는
샘플 배달을 위해 판독기 개체 또는 동기 판독기 개체에 의해 자동으로 생성됩니다.
입력 미디어 속성 입력의 속성을 관리합니다. 각 입력에 대해 하나의 입력 속성 개체가 있을 수 있습니다. IWMWriter::GetInputProps
상호 제외 프로필에서 상호 제외 정보를 관리합니다. 상호 제외의 일반적인 용도는 여러 언어의 여러 비트 전송률 콘텐츠 및 사운드트랙입니다. 새 상호 제외 개체를 만들거나 기존 개체에 액세스할지 여부에 따라 상호 제외 개체를 만드는 방법에는 여러 가지가 있습니다. IWMProfile::CreateNewMutualExclusion또는
IWMProfile::GetMutualExclusion
출력 미디어 속성 출력의 속성을 관리합니다. 각 출력에 대해 하나의 출력 미디어 속성 개체가 있을 수 있습니다. 이러한 개체는 판독기 또는 동기 판독기에서 만들 수 있습니다. IWMReader::GetOutputProps또는
IWMSyncReader::GetOutputProps
Profile 조작되는 동안 프로필의 데이터를 포함합니다. 프로필 개체는 프로필을 조작해야 할 때마다 만들어집니다. 새 프로필을 만들거나 기존 프로필에 액세스할지 여부에 따라 프로필 개체를 만드는 방법에는 여러 가지가 있습니다. IWMProfileManager::CreateEmptyProfile또는
IWMProfileManager::LoadProfileByData
또는
IWMProfileManager::LoadProfileByID
또는
IWMProfileManager::LoadSystemProfile
스트림 구성 프로필 내에서 스트림의 속성을 관리합니다. 스트림 구성 개체는 스트림에 대한 정보에 액세스해야 할 때마다 스트림 개체에 의해 만들어집니다. 새 스트림을 만들 것인지 아니면 액세스하고 기존 스트림을 만들 것인지에 따라 스트림 구성 개체를 만드는 방법에는 여러 가지가 있습니다. IWMProfile::CreateNewStream또는
IWMProfile::GetStream
또는
IWMProfile::GetStreamByNumber
스트림 우선 순위 지정 프로필의 스트림 우선 순위 목록을 유지 관리합니다. 사용 가능한 대역폭이 제한된 경우 우선 순위가 높아지는 순서대로 스트림이 삭제됩니다. 프로필에는 하나의 스트림 우선 순위 지정 개체만 있을 수 있습니다. IWMProfile3::CreateNewStreamPrioritization

프로그래밍 참조