Vytvoření seznamu požadavků na prostředky

Když ovladač sběrnice zjistí podřízené zařízení, je ovladač zodpovědný za vytvoření seznamu požadavků na prostředky pro dané zařízení. Každá položka v seznamu je logická konfigurace zařízení.

Poté co ovladač hlásí zařízení během výčtu sběrnice, rámec zavolá funkci zpětného volání EvtDeviceResourceRequirementsQuery. Tato funkce zpětného volání přijímá popisovač objektu seznamu požadavků na prostředky, který představuje prázdný seznam těchto požadavků.

Ovladač pak musí pro přidání informací do seznamu požadavků na prostředky provést následující kroky:

• Vytvořte prázdnou logickou konfiguraci.

  Pro každou logickou konfiguraci, kterou ovladač určí, musí ovladač volat WdfIoResourceListCreate, aby vytvořil prázdnou logickou konfiguraci.

• Přidejte deskriptory prostředků do logické konfigurace.

  Chcete-li přidat popisovače prostředků do logické konfigurace, musí ovladač provést následující kroky pro každý typ hardwarového prostředku, který zařízení vyžaduje:

  1. Vyplňte strukturu IO_RESOURCE_DESCRIPTOR přidělenou řidičem, která určuje rozsah platných hodnot pro konkrétní prostředek.
  2. Zavolejte WdfIoResourceListAppendDescriptor nebo WdfIoResourceListInsertDescriptor pro přidání obsahu struktury IO_RESOURCE_DESCRIPTOR do logické konfigurace.

  Pokud zařízení používá více než jednu instanci typu prostředku, všechny ovladače ve vrstvě, které přistupují k prostředku, musí vědět, v jakém pořadí se prostředky přidávají. Pokud například zařízení vyžaduje dva rozsahy adres portů vstupně-výstupních operací, musí všechny ovladače, které přistupují k popisovačům prostředků, vědět o pořadí, ve kterém jsou obě oblasti přidány do logické konfigurace.

• Přidejte logickou konfiguraci do seznamu požadavků na prostředky.

  Chcete-li přidat logickou konfiguraci do seznamu požadavků na prostředky zařízení, ovladač volá WdfIoResourceRequirementsListAppendIoResList nebo WdfIoResourceRequirementsListInsertIoResList.

  Při přiřazování prostředků k zařízení se správce PnP pokusí splnit požadavky první logické konfigurace v seznamu. Pokud prostředky požadované pro danou konfiguraci nejsou k dispozici, správce PnP odpovídá další konfiguraci v seznamu, pro které prostředky jsou k dispozici.

  Pokud ovladač podporuje jiné zařízení než PnP, ovladač obvykle musí také volat WdfIoResourceRequirementsListSetSlotNumber a WdfIoResourceRequirementsListSetInterfaceType.

Jakmile funkce zpětného volání ovladače EvtDeviceResourceRequirementsQuery vrátí, framework předá seznam požadavků na prostředky manažeru PnP.