Metodo IAMVideoControl::GetMaxAvailableFrameRate (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetMaxAvailableFrameRate metodo recupera la velocità massima del frame attualmente disponibile, in base all'utilizzo della larghezza di banda del bus per le connessioni, ad esempio USB e IEEE 1394, in cui la velocità massima dei fotogrammi può essere limitata dalla disponibilità della larghezza di banda.

Sintassi

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

Parametri

[in] pPin

Puntatore al pin da cui recuperare la frequenza massima del frame.

[in] iIndex

Indice del formato da eseguire una query per la frequenza massima dei fotogrammi. Questo indice corrisponde all'ordine in cui i formati vengono enumerati da IAMStreamConfig::GetStreamCaps. Il valore deve essere compreso tra zero e il numero di strutture VIDEO_STREAM_CONFIG_CAPS supportate restituite da IAMStreamConfig::GetNumberOfCapabilities) meno uno.

[in] Dimensions

Dimensioni dell'immagine del fotogramma (larghezza e altezza) in pixel.

[out] MaxAvailableFrameRate

Puntatore alla velocità massima di frame disponibile. La frequenza dei fotogrammi viene espressa come durata del frame in unità a 100 nanosecondi.

Valore restituito

Restituisce un valore HRESULT che dipende dall'implementazione dell'interfaccia.

Requisiti

Vedi anche

Codici errore e esito positivo

Interfaccia IAMVideoControl

VIDEO_STREAM_CONFIG_CAPS Struttura