Compartilhar via


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

Recupera o tamanho, em bytes, do buffer necessário para armazenar o índice concluído.

Sintaxe

HRESULT GetIndexWriteSpace(
  [out] QWORD *pcbIndexWriteSpace
);

Parâmetros

[out] pcbIndexWriteSpace

Recebe o tamanho do índice, em bytes

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
S_OK
O método foi bem-sucedido.
MF_E_INDEX_NOT_COMMITTED
O índice não foi confirmado. Para obter mais informações; consulte Comentários.

Comentários

Use esse método para obter o tamanho do índice e, em seguida, alocar um buffer grande o suficiente para mantê-lo.

O índice deve ser confirmado com uma chamada paraIMFASFIndexer::CommitIndex antes de chamar IMFASFIndexer::GetIndexWriteSpace. Se o índice não for confirmado antes de GetIndexWriteSpace ser chamado, MF_E_INDEX_NOT_COMMITTED será retornado como resultado.

Chame IMFASFIndexer::GetCompletedIndex para gravar o índice concluído em um buffer de mídia.

Você não pode usar esse método em um cenário de leitura. 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

Confira também

Objeto Index do ASF

IMFASFIndexer