IWMDMMetaData::QueryByIndex 메서드(mswmdm.h)

QueryByIndex 메서드는 인덱스로 지정된 속성의 값을 검색합니다.

구문

HRESULT QueryByIndex(
  [in]  UINT              iIndex,
  [out] WCHAR             **ppwszName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **ppValue,
  [out] UINT              *pcbLength
);

매개 변수

[in] iIndex

속성의 인덱스(0부터 시작)를 지정하는 정수입니다. GetItemCount 호출을 통해 가져온 항목 수입니다.

[out] ppwszName

속성의 이름입니다. Windows Media 장치 관리자 이 메모리를 할당하고 호출자는 CoTaskMemFree를 사용하여 메모리를 해제해야 합니다.

[out] pType

ppValue에서 반환되는 데이터 형식을 설명하는 WMDM_TAG_DATATYPE 열거형 값입니다.

[out] ppValue

메서드가 성공하면 값의 내용을 수신하는 바이트 배열에 대한 포인터에 대한 포인터입니다. 이 메모리는 Windows Media 장치 관리자 할당되며 호출자는 CoTaskMemFree를 사용하여 메모리를 해제해야 합니다.

[out] pcbLength

바이트 배열 ppValue의 크기(바이트)에 대한 포인터입니다. 값이 문자열인 경우 종료 문자가 포함됩니다.

반환 값

이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스 중 어느 것을 반환할 수 있습니다.

• 표준 COM 오류 코드
• HRESULT 값으로 변환된 Windows 오류 코드
• Windows Media 장치 관리자 오류 코드

요구 사항

추가 정보

GetItemCount

IWMDMMetaData 인터페이스

QueryByName

파일에서 메타데이터 설정