Método IAMVideoControl::GetMaxAvailableFrameRate (strmif.h)

Artigo
07/28/2023

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 GetMaxAvailableFrameRate método recupera a taxa máxima de quadros atualmente disponível, com base no uso da largura de banda do barramento para conexões, como USB e IEEE 1394, em que a taxa máxima de quadros pode ser limitada pela disponibilidade de largura de banda.

Sintaxe

HRESULT GetMaxAvailableFrameRate(
  [in]  IPin     *pPin,
  [in]  long     iIndex,
  [in]  SIZE     Dimensions,
  [out] LONGLONG *MaxAvailableFrameRate
);

Parâmetros

[in] pPin

Ponteiro para o pino do qual recuperar a taxa máxima de quadros.

[in] iIndex

Índice do formato a ser consultado quanto à taxa máxima de quadros. Esse índice corresponde à ordem na qual os formatos são enumerados por IAMStreamConfig::GetStreamCaps. O valor deve variar entre zero e o número de estruturas de VIDEO_STREAM_CONFIG_CAPS com suporte retornadas por IAMStreamConfig::GetNumberOfCapabilities) menos uma.

[in] Dimensions

Tamanho da imagem do quadro (largura e altura) em pixels.

[out] MaxAvailableFrameRate

Ponteiro para a taxa máxima de quadros disponível. A taxa de quadros é expressa como duração do quadro em unidades de 100 nanossegundos.

Retornar valor

Retorna um valor HRESULT que depende da implementação da interface .

Requisitos


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

IAMVideoControl Interface

Estrutura VIDEO_STREAM_CONFIG_CAPS

Compartilhar via