METODE IMFASFIndexer::GetIndexStatus (wmcontainer.h)

Artikel
03/04/2024

Mengambil pengaturan indeks untuk aliran dan jenis indeks tertentu.

Sintaks

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

Parameter

[in] pIndexIdentifier

Arahkan ke struktur ASF_INDEX_IDENTIFIER yang berisi nomor aliran dan jenis indeks untuk mendapatkan status.

[out] pfIsIndexed

Variabel yang mengambil nilai Boolean yang menentukan apakah indeks yang dijelaskan oleh pIndexIdentifier telah dibuat.

[out] pbIndexDescriptor

Buffer yang menerima deskriptor indeks. Deskriptor indeks terdiri dari struktur ASF_INDEX_DESCRIPTOR , secara opsional diikuti oleh data khusus indeks.

[in, out] pcbIndexDescriptor

Pada input, menentukan ukuran, dalam byte, dari buffer yang dituju pbIndexDescriptor . Nilainya bisa nol jika pbIndexDescriptor adalah NULL. Pada output, menerima ukuran deskriptor indeks, dalam byte.

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
MF_E_BUFFERTOOSMALL	Ukuran buffer yang ditentukan dalam pcbIndexDescriptor terlalu kecil.

Keterangan

Untuk membaca indeks ASF yang ada, panggil IMFASFIndexer::SetIndexByteStreams sebelum memanggil metode ini.

Jika indeks ada untuk aliran dan nilai yang diteruskan ke pcbIndexDescriptor lebih kecil dari ukuran buffer pbIndexDescriptor yang diperlukan, metode mengembalikan MF_E_BUFFERTOOSMALL. Ukuran buffer yang diperlukan dikembalikan dalam parameter pcbIndexDescriptor .

Jika tidak ada indeks untuk aliran yang ditentukan, metode mengembalikan FALSE dalam parameter pfIsIndexed .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wmcontainer.h
Pustaka	Mfuuid.lib

Lihat juga

Objek Indeks ASF

IMFASFIndexer

Bagikan melalui