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 |
---|---|
|
Êxito. |
|
Os valores retornados são estimativas; por exemplo, se o arquivo estiver sendo lido em uma rede. |
|
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 |