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 |
|---|---|
|
Il metodo è riuscito. |
|
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 |