Método IMFASFIndexer::CommitIndex (wmcontainer.h)

  • Artículo

Agrega información sobre un nuevo índice al objeto ContentInfo asociado al contenido de ASF. Debe llamar a este método antes de copiar el índice en el contenido para que el indexador pueda leerlo más adelante.

Sintaxis

HRESULT CommitIndex(
  [in] IMFASFContentInfo *pIContentInfo
);

Parámetros

[in] pIContentInfo

Puntero a la interfaz IMFASFContentInfo del objeto ContentInfo que describe el contenido.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_INVALIDREQUEST
 El autor de la llamada realizó una solicitud no válida. Para obtener más información, vea la sección Comentarios.

Comentarios

Para que el índice funcione correctamente, debe llamar a este método después de que todos los paquetes ASF del archivo se hayan pasado al indexador mediante el método IMFASFIndexer::GenerateIndexEntries . Después de llamar a este método, debe recuperar los índices llamando a GetCompletedIndex y escribirlos en la ubicación adecuada del archivo. Por último, debe generar un nuevo encabezado ASF llamando al método IMFASFContentInfo::GenerateHeader del objeto ContentInfo de ASF.

Una aplicación debe usar el método CommitIndex solo cuando se escribe un nuevo índice; de lo contrario , CommitIndex puede devolver MF_E_INVALIDREQUEST como resultado. Por ejemplo, MF_E_INVALIDREQUEST se devuelve si la aplicación tiene marcas distintas de MFASF_INDEXER_WRITE_NEW_INDEX establecidas en el objeto indexador. CommitIndex también puede devolver MFASF_INDEXER_WRITE_NEW_INDEX si las entradas del índice ya se han confirmado a través de una llamada a CommitIndex anterior.

No puede usar este método en un escenario de lectura de índices. Solo puede usar este método al escribir índices.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wmcontainer.h
Library Mfuuid.lib

Consulte también

Objeto de índice de ASF

IMFASFIndexer

MFCreateASFIndexer