IMFASFIndexer::GetIndexStatus-Methode (wmcontainer.h)

  • Artikel

Ruft die Indexeinstellungen für einen angegebenen Stream und Indextyp ab.

Syntax

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

Parameter

[in] pIndexIdentifier

Zeiger auf eine ASF_INDEX_IDENTIFIER-Struktur, die die Datenstromnummer und den Indextyp enthält, für die die status abgerufen werden sollen.

[out] pfIsIndexed

Eine Variable, die einen booleschen Wert abruft, der angibt, ob der von pIndexIdentifier beschriebene Index erstellt wurde.

[out] pbIndexDescriptor

Ein Puffer, der den Indexdeskriptor empfängt. Der Indexdeskriptor besteht aus einer ASF_INDEX_DESCRIPTOR-Struktur , optional gefolgt von indexspezifischen Daten.

[in, out] pcbIndexDescriptor

Gibt bei der Eingabe die Größe des Puffers in Bytes an, auf den pbIndexDescriptor zeigt. Der Wert kann null sein, wenn pbIndexDescriptorNULL ist. Empfängt bei der Ausgabe die Größe des Indexdeskriptors in Bytes.

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_BUFFERTOOSMALL
 Die in pcbIndexDescriptor angegebene Puffergröße ist zu klein.

Hinweise

Um einen vorhandenen ASF-Index zu lesen, rufen Sie vor dem Aufrufen dieser Methode IMFASFIndexer::SetIndexByteStreams auf.

Wenn ein Index für den Stream vorhanden ist und der an pcbIndexDescriptor übergebene Wert kleiner als die erforderliche Größe des pbIndexDescriptor-Puffers ist, gibt die Methode MF_E_BUFFERTOOSMALL zurück. Die erforderliche Puffergröße wird im parameter pcbIndexDescriptor zurückgegeben.

Wenn kein Index für den angegebenen Stream vorhanden ist, gibt die Methode false im pfIsIndexed-Parameter zurück.

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