Metodo IMFASFIndexer::GetIndexStatus (wmcontainer.h)

Articolo
08/28/2023

Recupera le impostazioni di indice per un flusso e un tipo di indice specificati.

Sintassi

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

Parametri

[in] pIndexIdentifier

Puntatore a una struttura ASF_INDEX_IDENTIFIER che contiene il numero di flusso e il tipo di indice per cui ottenere lo stato.

[out] pfIsIndexed

Variabile che recupera un valore booleano che specifica se è stato creato l'indice descritto da pIndexIdentifier .

[out] pbIndexDescriptor

Buffer che riceve il descrittore di indice. Il descrittore di indice è costituito da una struttura ASF_INDEX_DESCRIPTOR , seguita facoltativamente da dati specifici dell'indice.

[in, out] pcbIndexDescriptor

In input, specifica le dimensioni, in byte, del buffer a cui punta pbIndexDescriptor . Il valore può essere zero se pbIndexDescriptor è NULL. Nell'output, riceve le dimensioni del descrittore di indice, in byte.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
MF_E_BUFFERTOOSMALL	La dimensione del buffer specificata in pcbIndexDescriptor è troppo piccola.

Commenti

Per leggere un indice ASF esistente, chiamare IMFASFIndexer::SetIndexByteStreams prima di chiamare questo metodo.

Se esiste un indice per il flusso e il valore passato in pcbIndexDescriptor è inferiore alle dimensioni necessarie del buffer pbIndexDescriptor , il metodo restituisce MF_E_BUFFERTOOSMALL. La dimensione del buffer richiesta viene restituita nel parametro pcbIndexDescriptor .

Se non è presente alcun indice per il flusso specificato, il metodo restituisce FALSE nel parametro pfIsIndexed .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wmcontainer.h
Libreria	Mfuuid.lib

Vedi anche

Oggetto ASF Index

IMFASFIndexer

Condividi tramite