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
S_OK	Operazione completata.
E_POINTER	Valore puntatore NULL.
VFW_E_NOT_CONNECTED	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

Vedi anche

Codici errore e esito positivo

Interfaccia IAMStreamConfig