Metodo IAMStreamConfig::GetNumberOfCapabilities (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 GetNumberOfCapabilities metodo recupera il numero di funzionalità di formato supportate da questo pin.
Sintassi
HRESULT GetNumberOfCapabilities(
[out] int *piCount,
[out] int *piSize
);
Parametri
[out] piCount
Puntatore a una variabile che riceve il numero di funzionalità di formato.
[out] piSize
Puntatore a una variabile che riceve le dimensioni della struttura di configurazione in byte. Per ulteriori informazioni, vedere la sezione Osservazioni.
Valore restituito
Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Valore puntatore NULL. |
|
Il pin di input non è connesso. |
Commenti
Un pin di output può supportare più di un set di funzionalità di formato. Questo metodo restituisce il numero totale di funzionalità supportate dal pin; il numero viene restituito nel parametro piCount . Per recuperare un determinato set di funzionalità, chiamare il metodo IAMStreamConfig::GetStreamCaps . Le funzionalità di formato vengono indicizzate da zero, quindi il valore restituito in piCount è uno più del limite superiore.
A seconda del tipo di formato del pin, la struttura VIDEO_STREAM_CONFIG_CAPS (per video) o una struttura AUDIO_STREAM_CONFIG_CAPS (per l'audio). Il parametro piSize riceve le dimensioni della struttura, in byte.
In alcuni filtri di compressione questo metodo ha esito negativo se il pin di input del filtro non è connesso.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |