Condividi tramite


Metodo IMFASFIndexer::CommitIndex (wmcontainer.h)

Aggiunge informazioni su un nuovo indice all'oggetto ContentInfo associato al contenuto ASF. È necessario chiamare questo metodo prima di copiare l'indice nel contenuto in modo che l'indice venga leggibile in un secondo momento dall'indicizzatore.

Sintassi

HRESULT CommitIndex(
  [in] IMFASFContentInfo *pIContentInfo
);

Parametri

[in] pIContentInfo

Puntatore all'interfaccia FMASFContentInfo dell'oggetto ContentInfo che descrive il contenuto.

Valore restituito

Il metodo restituisce un 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_INVALIDREQUEST
Il chiamante ha effettuato una richiesta non valida. Per altre informazioni, vedere la sezione Osservazioni.

Commenti

Affinché l'indice funzioni correttamente, è necessario chiamare questo metodo dopo che tutti i pacchetti ASF nel file sono stati passati all'indicizzatore usando il metodo IMFASFIndexer::GenerateIndexEntries . Dopo aver chiamato questo metodo, è necessario recuperare gli indici chiamando GetCompletedIndex e scriverli nel percorso appropriato nel file. Infine, è necessario generare una nuova intestazione ASF chiamando il metodo IMFASFContentInfo::GenerateHeader dell'oggetto ContentInfo ASF.

Un'applicazione deve usare il metodo CommitIndex solo quando si scrive un nuovo indice altrimenti CommitIndex può restituire MF_E_INVALIDREQUEST di conseguenza. Ad esempio, MF_E_INVALIDREQUEST viene restituito se l'applicazione dispone di flag diversi da MFASF_INDEXER_WRITE_NEW_INDEX impostati sull'oggetto indicizzatore. CommitIndex può anche restituire MFASF_INDEXER_WRITE_NEW_INDEX se le voci di indice sono già state sottoposte a commit tramite una chiamata CommitIndex precedente.

Non è possibile usare questo metodo in uno scenario di lettura dell'indice. È possibile usare questo metodo solo durante la scrittura di indici.

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

MFCreateASFIndexer