Vyhledání a mapování hardwarových prostředků v ovladačích UMDF 1.x

Výstraha

UMDF 2 je nejnovější verze UMDF a nahrazuje UMDF 1. Všechny nové ovladače UMDF by měly být zapsány pomocí UMDF 2. Do UMDF 1 se nepřidávají žádné nové funkce a v novějších verzích Windows 10 je omezená podpora UMDF 1. Univerzální ovladače systému Windows musí používat UMDF 2.

Archivované ukázky UMDF 1 najdete v aktualizaci ovladačů pro Windows 11, verze 22H2 z května 2022 – .

Další informace najdete v tématu Začínáme s UMDF.

Pokud používáte UMDF verze 2.0 nebo novější, přečtěte si téma Hledání a mapování hardwarových prostředků.

Ovladač UMDF 1.x přijímá hardwarové prostředky ve své metodě zpětného volání IPnpCallbackHardware2::OnPrepareHardware. Ovladač používá rozhraní IWDFCmResourceList ke kontrole přeloženého seznamu prostředků a identifikaci registrů mapovaných paměti, vstupně-výstupních portů a přerušení.

Ovladač iteruje prostřednictvím seznamu prostředků voláním IWDFCmResourceList::GetCount a IWDFCmResourceList::GetDescriptor.

Pokud ovladač obdrží paměťově mapované registry, musí ovladač volat IWDFDevice3::MapIoSpace, aby k nim mohl získat přístup. Ovladač obvykle mapuje své registry v metodě IPnpCallbackHardware2::OnPrepareHardware. Ovladač zruší mapování registrů v IPnpCallbackHardware2::OnReleaseHardware zpětné volání použitím IWDFDevice3::UnmapIoSpace. Upozorňujeme, že mapování není potřeba pro vstupně-výstupní porty.

Příklad, který ukazuje, jak ovladač najde a mapuje paměťové mapované registrové prostředky, viz IWDFDevice3::MapIoSpace.