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

지정된 인덱스에서 특성을 검색합니다.

구문

HRESULT GetItemByIndex(
  [in]      UINT32      unIndex,
  [out]     GUID        *pguidKey,
  [in, out] PROPVARIANT *pValue
);

매개 변수

[in] unIndex

검색할 특성의 인덱스입니다. 특성 수를 얻으려면 IMFAttributes::GetCount를 호출합니다.

[out] pguidKey

이 특성을 식별하는 GUID를 받습니다.

[in, out] pValue

값을 받는 PROPVARIANT 에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. NULL이 아닌 경우 메서드는 PROPVARIANT를 특성 값의 복사본으로 채웁니다. PropVariantClear를 호출하여 이 메서드에서 할당한 메모리를 해제합니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_INVALIDARG	인덱스가 잘못되었습니다.

설명

스레드로부터 안전한 방식으로 개체의 모든 특성을 열거하려면 다음을 수행합니다.

1. IMFAttributes::LockStore를 호출하여 다른 스레드가 특성을 추가하거나 삭제하지 못하도록 합니다.
2. IMFAttributes::GetCount를 호출하여 특성 수를 찾습니다.
3. GetItemByIndex를 호출하여 인덱스별로 각 특성을 가져옵니다.
4. IMFAttributes::UnlockStore를 호출하여 특성 저장소의 잠금을 해제합니다.

이 인터페이스는 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