IMFAttributes::SetItem 메서드(mfobjects.h)

  • 아티클

지정된 키를 사용하여 특성 값을 추가합니다.

구문

HRESULT SetItem(
  [in] REFGUID        guidKey,
  [in] REFPROPVARIANT Value
);

매개 변수

[in] guidKey

설정할 값을 식별하는 GUID입니다. 이 키가 이미 있는 경우 메서드는 이전 값을 덮어씁니다.

[in] Value

특성 값을 포함하는 PROPVARIANT 입니다. 메서드는 값을 복사합니다. PROPVARIANT 형식은 MF_ATTRIBUTE_TYPE 열거형에 나열된 형식 중 하나여야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드 Description
S_OK
 메서드가 성공했습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.
MF_E_INVALIDTYPE
 잘못된 특성 유형입니다.

설명

이 메서드는 PROPVARIANT 형식이 MF_ATTRIBUTE_TYPE 정의된 특성 형식 중 하나인지 확인하고 지원되지 않는 형식이 사용되는 경우 실패합니다. 그러나 이 메서드는 PROPVARIANT가 지정된 특성 GUID에 대한 올바른 형식인지 여부를 검사 않습니다. (특성 GUID를 속성 형식과 연결하는 프로그래밍 방식의 방법은 없습니다.) Media Foundation 특성 및 해당 데이터 형식 목록은 Media Foundation 특성을 참조하세요.

이 인터페이스는 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 포함)
라이브러리 Mfuuid.lib

추가 정보

특성 및 속성

IMFAttributes