Architektura WDF

WDF poskytuje pro ovladače rozhraní založená na objektech. Rozhraní objektů definovaná architekturou se skládají z:

objektové metody
Metody jsou funkce, které ovladač může volat k provedení operace s objektem nebo získat nebo nastavit vlastnost objektu. Metody jsou pojmenovány WdfObjectAction, kde Object popisuje objekt a Akce označuje, co funkce dělá. Například WdfDeviceCreate vytvoří objekt zařízení.

funkce zpětného volání událostí objektu
Funkce zpětného volání událostí jsou funkce, které ovladač poskytuje. Každá funkce zpětného volání události je přidružená ke konkrétní události, která může na objektu nastat. Rozhraní volá funkci zpětného volání události, když dojde k přidružené události. Podle konvence se zástupné symboly pro funkce zpětného volání událostí nazývají EvtObjectEvent, i když tyto zpětná volání můžete pojmenovat cokoli, co zvolíte v ovladači. Například ovladač zaregistruje zpětné volání události EvtDeviceD0Entry, aby byl upozorněn, když jeho zařízení přejde do pracovního stavu.

vlastnosti objektu
Vlastnosti jsou hodnoty, které jsou uloženy v objektu a že ovladač může získat (to znamená získat) a nastavit (to znamená změnit). V mnoha případech se vlastnosti mapují přímo na pole v odpovídajících objektech WDM. Vlastnosti, které nemohou selhat, mají název WdfObjektZískatHodnotu a WdfObjektNastavitHodnotu, a vlastnosti, které mohou selhat, mají název WdfObjektNačístHodnotu a WdfObjektPřiřaditHodnotu. Objekt popisuje objekt a Hodnota identifikuje data, která funkce nastaví nebo vrátí. Například WdfDeviceGetDriver vrací popisovač objektu ovladače, přidruženého k objektu zařízení.

Objekt zpracovává
Ovladač založený na rozhraní nikdy nepřistupuje přímo k objektům architektury. Místo toho ovladač přijímá popisovače objektů, které může předat metodám objektu.

Architektura definuje několik typů objektů, které používají ovladače založené na rozhraní:

• Objekt ovladače architektury představuje každý ovladač.

• Objekt zařízení framework představuje každé zařízení, které ovladač podporuje.

• Objekty fronty rozhraní představují vstupně-výstupní fronty, které přijímají vstupně-výstupní požadavky zařízení.

• objekty požadavků rozhraní představují vstupně-výstupní požadavky, které přijímá každá vstupně-výstupní fronta.

Seznam všech objektů, které architektura definuje, naleznete v tématu Souhrn objektů rozhraní.