Freigeben über


IMFASFIndexer::GetIndexWriteSpace-Methode (wmcontainer.h)

Ruft die Größe des Puffers in Bytes ab, der zum Speichern des abgeschlossenen Indexes erforderlich ist.

Syntax

HRESULT GetIndexWriteSpace(
  [out] QWORD *pcbIndexWriteSpace
);

Parameter

[out] pcbIndexWriteSpace

Empfängt die Größe des Indexes in Byte.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
MF_E_INDEX_NOT_COMMITTED
Der Index wurde nicht committet. Weitere Informationen; siehe Hinweise.

Hinweise

Verwenden Sie diese Methode, um die Größe des Indexes abzurufen, und weisen Sie dann einen Puffer zu, der groß genug ist, um ihn zu halten.

Der Index muss mit einem Aufruf vonIMFASFIndexer::CommitIndex vor dem Aufrufen von IMFASFIndexer::GetIndexWriteSpace committet werden. Wenn für den Index kein Commit ausgeführt wird, bevor GetIndexWriteSpace aufgerufen wird, wird als Ergebnis MF_E_INDEX_NOT_COMMITTED zurückgegeben.

Rufen Sie IMFASFIndexer::GetCompletedIndex auf, um den abgeschlossenen Index in einen Medienpuffer zu schreiben.

Sie können diese Methode nicht in einem Leseszenario verwenden. Sie können diese Methode nur beim Schreiben von Indizes verwenden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wmcontainer.h
Bibliothek Mfuuid.lib

Weitere Informationen

ASF-Indexobjekt

IMFASFIndexer