Método IMFASFIndexer::CommitIndex (wmcontainer.h)
Adiciona informações sobre um novo índice ao objeto ContentInfo associado ao conteúdo ASF. Você deve chamar esse método antes de copiar o índice para o conteúdo para que o índice seja legível pelo indexador posteriormente.
Sintaxe
HRESULT CommitIndex(
[in] IMFASFContentInfo *pIContentInfo
);
Parâmetros
[in] pIContentInfo
Ponteiro para a interface IMFASFContentInfo do objeto ContentInfo que descreve o conteúdo.
Retornar valor
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
Código de retorno | Descrição |
---|---|
|
O método foi bem-sucedido. |
|
O chamador fez uma solicitação inválida. Para obter mais informações, consulte Comentários. |
Comentários
Para que o índice funcione corretamente, você deve chamar esse método depois que todos os pacotes ASF no arquivo tiverem sido passados para o indexador usando o método IMFASFIndexer::GenerateIndexEntries . Depois de chamar esse método, você deve recuperar os índices chamando GetCompletedIndex e gravá-los no local apropriado no arquivo. Por fim, você deve gerar um novo cabeçalho ASF chamando o método IMFASFContentInfo::GenerateHeader do objeto ContentInfo do ASF.
Um aplicativo deve usar o método CommitIndex somente ao gravar um novo índice; caso contrário , CommitIndex pode retornar MF_E_INVALIDREQUEST como resultado. Por exemplo, MF_E_INVALIDREQUEST será retornado se o aplicativo tiver sinalizadores diferentes de MFASF_INDEXER_WRITE_NEW_INDEX definidos no objeto do indexador. CommitIndex também poderá retornar MFASF_INDEXER_WRITE_NEW_INDEX se as entradas de índice já tiverem sido confirmadas por meio de uma chamada CommitIndex anterior.
Você não pode usar esse método em um cenário de leitura de índice. Você só pode usar esse método ao escrever índices.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | wmcontainer.h |
Biblioteca | Mfuuid.lib |