IMFASFIndexer::GetIndexStatus 메서드(wmcontainer.h)

지정된 스트림 및 인덱스 형식에 대한 인덱스 설정을 검색합니다.

구문

HRESULT GetIndexStatus(
  [in]      ASF_INDEX_IDENTIFIER *pIndexIdentifier,
  [out]     BOOL                 *pfIsIndexed,
  [out]     BYTE                 *pbIndexDescriptor,
  [in, out] DWORD                *pcbIndexDescriptor
);

매개 변수

[in] pIndexIdentifier

상태 가져올 스트림 번호 및 인덱스 형식을 포함하는 ASF_INDEX_IDENTIFIER 구조체에 대한 포인터입니다.

[out] pfIsIndexed

pIndexIdentifier에서 설명하는 인덱스가 만들어졌는지 여부를 지정하는 부울 값을 검색하는 변수입니다.

[out] pbIndexDescriptor

인덱스 설명자를 받는 버퍼입니다. 인덱스 설명자는 선택적으로 인 덱스 관련 데이터 뒤에 ASF_INDEX_DESCRIPTOR 구조로 구성됩니다.

[in, out] pcbIndexDescriptor

입력에서 pbIndexDescriptor 가 가리키는 버퍼의 크기(바이트)를 지정합니다. pbIndexDescriptor가 NULL인 경우 값은 0일 수 있습니다. 출력에서 는 인덱스 설명자의 크기(바이트)를 받습니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_BUFFERTOOSMALL	pcbIndexDescriptor에 지정된 버퍼 크기가 너무 작습니다.

설명

기존 ASF 인덱스를 읽으려면 이 메서드를 호출하기 전에 IMFASFIndexer::SetIndexByteStreams 를 호출합니다.

스트림에 대한 인덱스가 있고 pcbIndexDescriptor에 전달된 값이 pbIndexDescriptor 버퍼의 필요한 크기보다 작은 경우 메서드는 MF_E_BUFFERTOOSMALL 반환합니다. 필요한 버퍼 크기는 pcbIndexDescriptor 매개 변수에 반환됩니다.

지정된 스트림에 대한 인덱스가 없으면 메서드는 pfIsIndexed 매개 변수에서 FALSE를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wmcontainer.h
라이브러리	Mfuuid.lib

추가 정보

ASF 인덱스 개체

IMFASFIndexer