Udostępnij przez


Zestawy właściwości (DirectShow)

[Funkcja skojarzona z tą stroną, DirectShow, jest starszą funkcją. Został zastąpiony przez MediaPlayer, IMFMediaEnginei Audio/Video Capture w Media Foundation. Te funkcje zostały zoptymalizowane pod kątem systemów Windows 10 i Windows 11. Firma Microsoft zdecydowanie zaleca, aby nowy kod używał MediaPlayer, IMFMediaEngine i Audio/Video Capture w programie Media Foundation zamiast DirectShow, jeśli to możliwe. Firma Microsoft sugeruje, że istniejący kod, który używa starszych interfejsów API, należy przepisać go do korzystania z nowych interfejsów API, jeśli to możliwe.]

Program Microsoft DirectShow używa zestawów właściwości do obsługi rozszerzonych usług oferowanych przez sprzęt i skojarzone sterowniki i filtry. Dostawcy sprzętu i filtru mogą definiować nowe możliwości jako właściwości, rozmieszczać je w zestawach właściwości i publikować specyfikację dla tych zestawów właściwości. Jako deweloper aplikacji można użyć metod interfejsu IKsPropertySet, aby określić, czy sterownik lub filtr obsługuje określony zestaw właściwości, i pobrać lub ustawić te właściwości.

Wszystkie metody uwidocznione przez IKsPropertySet wymagają identyfikatora GUID identyfikującego zestaw właściwości (parametr guidPropSet) i DWORD identyfikujący właściwość w zestawie właściwości (parametr dwPropID). Parametr dwPropID jest zazwyczaj elementem członkowskim wyliczonego typu danych.

Poszczególne właściwości mogą mieć skojarzone dane określone w parametrze pPropData w metodach IKsPropertySet::Set i IKsPropertySet::Get. W tych metodach dane właściwości są wpisywane jako wskaźnik void. Typ danych i znaczenie danych są określone w definicji zestawu właściwości.

Poniższe sekcje zawierają informacje o zestawach właściwości obsługiwanych w programie DirectShow: