Méthode IMFASFIndexer ::CommitIndex (wmcontainer.h)
Ajoute des informations sur un nouvel index à l’objet ContentInfo associé au contenu ASF. Vous devez appeler cette méthode avant de copier l’index dans le contenu afin que l’index soit lisible par l’indexeur ultérieurement.
Syntaxe
HRESULT CommitIndex(
[in] IMFASFContentInfo *pIContentInfo
);
Paramètres
[in] pIContentInfo
Pointeur vers l’interface IMFASFContentInfo de l’objet ContentInfo qui décrit le contenu.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
|
L’appelant a fait une demande non valide. Pour plus d'informations, consultez la section Notes. |
Remarques
Pour que l’index fonctionne correctement, vous devez appeler cette méthode une fois que tous les paquets ASF du fichier ont été passés à l’indexeur à l’aide de la méthode IMFASFIndexer ::GenerateIndexEntries . Après avoir appelé cette méthode, vous devez récupérer les index en appelant GetCompletedIndex et les écrire à l’emplacement approprié dans le fichier. Enfin, vous devez générer un nouvel en-tête ASF en appelant la méthode IMFASFContentInfo ::GenerateHeader de l’objet ASF ContentInfo.
Une application doit utiliser la méthode CommitIndex uniquement lors de l’écriture d’un nouvel index, sinon CommitIndex peut retourner MF_E_INVALIDREQUEST en conséquence. Par exemple, MF_E_INVALIDREQUEST est retourné si l’application a des indicateurs autres que MFASF_INDEXER_WRITE_NEW_INDEX définis sur l’objet indexeur. CommitIndex peut également retourner des MFASF_INDEXER_WRITE_NEW_INDEX si les entrées d’index ont déjà été validées via un appel CommitIndex antérieur.
Vous ne pouvez pas utiliser cette méthode dans un scénario de lecture d’index. Vous pouvez uniquement utiliser cette méthode lors de l’écriture d’index.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | wmcontainer.h |
| Bibliothèque | Mfuuid.lib |