IMFAttributes 인터페이스(mfobjects.h)
개체에 키/값 쌍을 저장하는 일반적인 방법을 제공합니다. 키는 GUID이며 값은 UINT32, UINT64, double, GUID, 와이드 문자열, 바이트 배열 또는 IUnknown 포인터와 같은 데이터 형식 중 하나일 수 있습니다. 이 인터페이스의 표준 구현은 값을 추가, 삭제 또는 검색하는 동안 스레드 잠금을 유지합니다.
미리 정의된 특성 GUID목록은 Media Foundation 특성을 참조하세요. 각 특성 GUID 에는 예상 데이터 형식이 있습니다. IMFAttributes의 다양한 "set" 메서드는 특성 GUID에 대해 형식의 유효성을 검사하지 않습니다. 특성에 대해 올바른 형식을 설정하는 것은 애플리케이션의 책임입니다.
빈 특성 저장소를 만들려면 MFCreateAttributes를 호출합니다.
상속
IMFAttributes 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IMFAttributes 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IMFAttributes 인터페이스에는 이러한 메서드가 있습니다.
| IMFAttributes::Compare 이 개체의 특성을 다른 개체의 특성과 비교합니다. |
| IMFAttributes::CompareItem 저장된 특성 값이 지정된 PROPVARIANT와 같은지 여부를 쿼리합니다. |
| IMFAttributes::CopyAllItems 이 개체의 모든 특성을 다른 특성 저장소에 복사합니다. |
| IMFAttributes::D eleteAllItems 개체의 특성 목록에서 모든 키/값 쌍을 제거합니다. |
| IMFAttributes::D eleteItem 개체의 특성 목록에서 키/값 쌍을 제거합니다. |
| IMFAttributes::GetAllocatedBlob 키와 연결된 바이트 배열을 검색합니다. 이 메서드는 배열에 대한 메모리를 할당합니다. |
| IMFAttributes::GetAllocatedString 키와 연결된 와이드 문자열을 가져옵니다. 이 메서드는 문자열에 대한 메모리를 할당합니다. |
| IMFAttributes::GetBlob 키와 연결된 바이트 배열을 검색합니다. 이 메서드는 배열을 호출자가 할당한 버퍼에 복사합니다. |
| IMFAttributes::GetBlobSize 키와 연결된 바이트 배열의 길이를 검색합니다. |
| IMFAttributes::GetCount 이 개체에 설정된 특성 수를 검색합니다. |
| IMFAttributes::GetDouble 키와 연결된 이중 값을 검색합니다. |
| IMFAttributes::GetGUID 키와 연결된 GUID 값을 검색합니다. |
| IMFAttributes::GetItem 키와 연결된 값을 검색합니다. |
| IMFAttributes::GetItemByIndex 지정된 인덱스에서 특성을 검색합니다. |
| IMFAttributes::GetItemType 키와 연결된 값의 데이터 형식을 검색합니다. |
| IMFAttributes::GetString 키와 연결된 와이드 문자열을 검색합니다. |
| IMFAttributes::GetStringLength 키와 연결된 문자열 값의 길이를 검색합니다. |
| IMFAttributes::GetUINT32 키와 연결된 UINT32 값을 검색합니다. |
| IMFAttributes::GetUINT64 키와 연결된 UINT64 값을 검색합니다. |
| IMFAttributes::GetUnknown 키와 연결된 인터페이스 포인터를 검색합니다. |
| IMFAttributes::LockStore 특성 저장소를 잠가 다른 스레드가 액세스할 수 없도록 합니다. |
| IMFAttributes::SetBlob 바이트 배열을 키와 연결합니다. |
| IMFAttributes::SetDouble double 값을 키와 연결합니다. |
| IMFAttributes::SetGUID GUID 값을 키와 연결합니다. |
| IMFAttributes::SetItem 지정된 키를 사용하여 특성 값을 추가합니다. |
| IMFAttributes::SetString 와이드 문자열을 키와 연결합니다. |
| IMFAttributes::SetUINT32 UINT32 값을 키와 연결합니다. |
| IMFAttributes::SetUINT64 UINT64 값을 키와 연결합니다. |
| IMFAttributes::SetUnknown IUnknown 포인터를 키와 연결합니다. |
| IMFAttributes::UnlockStore IMFAttributes::LockStore 메서드를 호출한 후 특성 저장소의 잠금을 해제합니다. 개체가 잠금 해제된 동안 여러 스레드가 개체의 특성에 액세스할 수 있습니다. |
설명
이 인터페이스는 Windows Media Format 11 SDK 재배포 가능 구성 요소가 설치된 경우 다음 플랫폼에서 사용할 수 있습니다.
- Windows XP SP2(서비스 팩 2) 이상
- KB900325(Windows XP Media Center Edition 2005) 및 KB925766(Windows XP Media Center Edition용 2006년 10월 업데이트 롤업)가 설치된 Windows XP Media Center Edition 2005.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | mfobjects.h(Mfidl.h 포함) |