Vlastnosti, události a metody KS

Architektura streamování jádra podporuje interakci mezi minidrivery a klienty v uživatelském režimu prostřednictvím vlastností, událostí a metod. Pomocí těchto konstruktorů můžou klienti objektu KS získat a nastavit stav objektu, zaregistrovat zpětné volání oznámení pro události a spouštět metody objektů.

Klienti požadují všechny tři třídy operací standardizovaným způsobem. Klient poskytuje strukturu aliasů KSIDENTIFIER ve volání DeviceIoControl (popsané v dokumentaci k sadě Microsoft Windows SDK) nebo KsSynchronousDeviceControl.

Struktury aliasů jsou KSPROPERTY, KSEVENT a KSMETHOD. Všechny tři zahrnují následující parametry:

• Nastavit

  Funkčně podobné operace jsou seskupené do sady. Každá vlastnost, událost nebo sada metod je identifikována identifikátorem GUID. Microsoft definuje identifikátory GUID pro standardní operace specifické pro technologie. Minidriveři můžou definovat vlastní identifikátory GUID pro vlastní operace.

• Identifikátor

  Každá operace je určena číslem ID v rámci sady.

• Identifikační údaje specifické pro operace

  Některé požadavky na vlastnosti vyžadují další data. Například piny na zvukovém zařízení podporují sadu vlastností KSPROPSETID_Audio. Zvukový pin může podporovat několik různých zvukových kanálů. Klienti, kteří získávají nebo nastavují určité vlastnosti KSPROPSETID_Audio, musí určit zvukový kanál, na který se požadavek vztahuje. Požadavky na události a metody nevyžadují další data.

GUID a identifikátory sad definované Microsoftem pro obecné operace se nacházejí v hlavičce ks.h. Standardní identifikátory GUID a identifikátory pro konkrétní třídy multimediálních technologií se nacházejí v ksmedia.h.

Minidrivery AVStream podporují vlastnosti, události a metody poskytnutím ukazatele na strukturu KSAUTOMATION_TABLE v příslušných KSFILTER_DESCRIPTOR nebo KSPIN_DESCRIPTOR_EX. KSAUTOMATION_TABLE obsahuje ukazatel na pole KSPROPERTY_SET objektů. Další informace najdete v tématu Definování automatizačních tabulek.

Tyto části obsahují informace o tom, jak minidriveři podporují tři třídy operací:

Vlastnosti KS

Události KS

Metody KS