Método IAsyncReader::Length (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O Length método recupera o comprimento total do fluxo.

Sintaxe

HRESULT Length(
  LONGLONG *pTotal,
  LONGLONG *pAvailable
);

Parâmetros

pTotal

Ponteiro para uma variável que recebe o comprimento do fluxo, em bytes.

pAvailable

Ponteiro para uma variável que recebe a parte do fluxo que está disponível no momento, em bytes.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
Êxito.
VFW_S_ESTIMATED
Os valores retornados são estimativas; por exemplo, se o arquivo estiver sendo lido em uma rede.
E_UNEXPECTED
O arquivo não está aberto ou não existe mais.

Comentários

Para fluxos recuperados em uma rede, o fluxo inteiro pode não estar disponível no início. As operações de leitura além do comprimento disponível podem ser bloqueadas por um longo período de tempo, até que essa parte do fluxo fique disponível.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IAsyncReader Interface