共用方式為

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，此值可以是零。 在輸出中，以位元組為單位接收索引描述元的大小。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。
MF_E_BUFFERTOOSMALL
 在 idIndexDescriptor 中指定的緩衝區大小太小。

備註

若要讀取現有的 ASF 索引，請先呼叫 IMFASFIndexer：：SetIndexByteStreams ，再呼叫此方法。

如果數據流有索引存在，而且傳入 於MF_E_BUFFERTOOSMALL的 pbIndexDescriptor 值小於 pbIndexDescriptor 緩衝區的必要大小。 必要緩衝區大小會傳回 於dexDescriptor 參數中。

如果指定的數據流沒有索引，方法會在 pfIsIndexed 參數中傳回 FALSE。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wmcontainer.h
程式庫 Mfuuid.lib

另請參閱

ASF 索引物件

IMFASFIndexer