Delen via


Eigenschappensets (DirectShow)

[De functie die is gekoppeld aan deze pagina, DirectShow, is een verouderde functie. Het is vervangen door MediaPlayer, IMFMediaEngineen Audio/Video Capture in Media Foundation. Deze functies zijn geoptimaliseerd voor Windows 10 en Windows 11. Microsoft raadt ten zeerste aan om nieuwe code te gebruiken MediaPlayer, IMFMediaEngine en Audio/Video Capture in Media Foundation in plaats van DirectShow, indien mogelijk. Microsoft stelt voor dat bestaande code die gebruikmaakt van de verouderde API's, indien mogelijk opnieuw worden geschreven om de nieuwe API's te gebruiken.]

Microsoft DirectShow maakt gebruik van eigenschappensets ter ondersteuning van uitgebreide services die worden aangeboden door hardware en de bijbehorende stuurprogramma's en filters. Hardware- en filterleveranciers kunnen nieuwe mogelijkheden definiëren als eigenschappen, deze rangschikken in eigenschappensets en de specificatie voor deze eigenschappensets publiceren. Als toepassingsontwikkelaar kunt u de methoden van de IKsPropertySet interface gebruiken om te bepalen of een stuurprogramma of filter een bepaalde set eigenschappen ondersteunt en deze eigenschappen ophalen of instellen.

Alle methoden die worden weergegeven door IKsPropertySet vereisen een GUID- die de eigenschappenset identificeert (de parameter guidPropSet) en een DWORD- waarmee de eigenschap in de eigenschappenset wordt geïdentificeerd (de parameter dwPropID). De parameter dwPropID is doorgaans lid van een geïnventariseerd gegevenstype.

Afzonderlijke eigenschappen kunnen gekoppelde gegevens bevatten die u opgeeft in de parameter pPropData in de IKsPropertySet::Set en IKsPropertySet::Get methoden. In deze methoden worden de eigenschapsgegevens getypt als een aanwijzer naar void. Het gegevenstype en de betekenis van de gegevens worden opgegeven in de definitie van de eigenschappenset.

De volgende secties bevatten informatie over de eigenschappensets die worden ondersteund in DirectShow: