Set di proprietà (DirectShow)

  • Articolo

[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.

Microsoft DirectShow usa set di proprietà per supportare i servizi estesi offerti dall'hardware e dai relativi driver e filtri associati. I fornitori di hardware e filtro possono definire nuove funzionalità come proprietà, organizzarle in set di proprietà e pubblicare la specifica per questi set di proprietà. Come sviluppatore di applicazioni, è possibile 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 una DWORD che identifica la proprietà all'interno del set di proprietà (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: