개체(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를 수동으로 사용하는 대신 생성 함수 또는 메서드를 사용하여 개체를 만들어야 합니다.
일부 인터페이스에는 이름에 IWMProfile2 및 IWMWriter3과 같은 번호가 추가되어 있습니다. 각 경우에 번호가 매겨진 버전은 이전 버전의 모든 메서드를 상속하고 새 기능을 추가합니다.
이 참조의 각 개체 페이지에서 기본 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 |