Vlastnosti KS

Vlastnost představuje schopnost nebo nastavení stavu řízení, které je součástí objektu streamování jádra, jako je filtr nebo pin. Klienti minidriveru streamování jádra můžou odesílat žádosti o získání a nastavení vlastností (KSPROPERTY_TYPE_GET a KSPROPERTY_TYPE_SET) na filtry a špendlíky, které minidriver vytvořil. Skupina souvisejících vlastností se označuje jako sada vlastností.

Chcete-li získat nebo nastavit jednotlivé vlastnosti, klienti v uživatelském režimu volají funkci Win32 DeviceIoControl s parametrem dwIoControlCode nastaveným na IOCTL_KS_PROPERTY. DeviceIoControl je popsán v dokumentaci sady Microsoft Windows SDK. Klienti režimu jádra by měli volat KsSynchronousDeviceControl.

Vstupní vyrovnávací paměť je buď struktura KSPROPERTY , nebo obálka obsahující strukturu KSPROPERTY a další informace relevantní pro požadavek. V reakci na toto volání operační systém odešle IRP třídnímu ovladači.

Když ovladač třídy obdrží výsledný IRP, volá KsPropertyHandler. Ovladač třídy zahrnuje jako parametr volání adresu struktury KSPROPERTY, která identifikuje specifika požadavku na vlastnost. Požadavek na vlastnost je zpracováván buď automaticky na úrovni ovladače třídy, nebo prostřednictvím obslužné rutiny poskytované minidriverem. Viz Sady vlastností streamování jádra pro referenční informace, včetně toho, které sady vlastností zpracovává ovladač třídy a které vyžadují obslužné rutiny poskytované minidriverem. Minidriver může přepsat nebo rozšířit obslužnou rutinu ovladače třídy poskytnutím zpětného volání pro vlastnost, která je ve výchozím nastavení zpracována ovladačem třídy.

Pokud minidriver poskytl obslužné rutiny pro tuto vlastnost, KsPropertyHandler následně předá požadavek příslušnému zpětnému volání dodanému minidriverem.

Minidriver poskytuje ukazatele na zpětná volání pro podporu svých vlastností ve struktuře typu KSPROPERTY_ITEM. Minidriver seskupuje pole příbuzných struktur KSPROPERTY_ITEM ve struktuře KSPROPERTY_SET. Různé modely třídních ovladačů mají pro minidriver mírně odlišné metody, jak zpřístupnit data sady vlastností třídnímu ovladači. Informace specifické pro ovladače třídy najdete na odkazech streamování jádra.

Minidriver také poskytuje ukazatel na strukturu KSPROPERTY_VALUES v rámci struktury KSPROPERTY_ITEM. Struktura KSPROPERTY_VALUES zase obsahuje pole KSPROPERTY_MEMBERSLIST struktur. Zde minidriver určuje velikost a typ přijatelných hodnot vlastnosti. Každá struktura KSPROPERTY_MEMBERSLIST obsahuje člena záhlaví: viz KSPROPERTY_MEMBERSHEADER Informace o tom, jak zadat právní rozsahy nebo hodnoty pro vlastnost, kterou minidriver podporuje. Implementaci tohoto mechanismu najdete také v ukázce Testcap v sadě Microsoft Windows Driver Kit (WDK).

Chcete-li hlásit velikost a typ přijatelných hodnot pro vlastnost, ovladač třídy vrátí strukturu KSPROPERTY_DESCRIPTION v reakci na požadavek KSPROPERTY_TYPE_BASICSUPPORT od klienta.

Ovladač třídy může k struktuře KSPROPERTY_DESCRIPTION připojit seznam struktur KSPROPERTY_MEMBERSHEADER.