Condividi tramite

Set di proprietà (DirectShow)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEnginee Acquisizione audio/video in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente di usare un nuovo codice MediaPlayer, IMFMediaEngine e Acquisizione audio/video 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.

Microsoft DirectShow usa set di proprietà per supportare i servizi estesi offerti dall'hardware e i relativi driver e filtri associati. I fornitori di hardware e filtri possono definire nuove funzionalità come proprietà, organizzarle in set di proprietà e pubblicare la specifica per questi set di proprietà. Gli sviluppatori di applicazioni possono usare i metodi dell'interfaccia IKsPropertySet per determinare se un driver o un filtro supporta un determinato set di proprietà e recuperare o impostare tali proprietà.

Tutti i metodi esposti da IKsPropertySet richiedono un GUID che identifica il set di proprietà (il parametro guidPropSet) e un DWORD che identifica la proprietà all'interno del set di proprietà (il parametro dwPropID). Il parametro dwPropID è in genere un membro di un tipo di dati enumerato.

Le singole proprietà possono avere dati associati specificati nel parametro pPropData nei metodi IKsPropertySet::Set e IKsPropertySet::Get. In questi metodi, i dati della proprietà vengono digitati come puntatore a void. Il tipo di dati e il significato dei dati vengono specificati nella definizione del set di proprietà.

Le sezioni seguenti forniscono informazioni sui set di proprietà supportati in DirectShow: