Vyhodnocení kontrolních metod ACPI

Metoda řízení pokročilého rozhraní pro konfiguraci a napájení (ACPI) je software, který deklaruje a definuje operace pro dotazování a konfiguraci systémového hardwaru. Systém kompatibilní s AKTI poskytuje minimální sadu kontrolních metod. Metody řízení jsou napsané ve zdrojovém jazyce ACPI (ASL), kompilované kompilátorem ASL do AML (ACPI Machine Language), načteny ze systémového firmwaru do oboru názvů ACPI a interpretovány ovladačem ACPI.

Ovladače zařízení v režimu jádra, které splňují požadavky rozhraníKernel-Mode Driver Framework (KMDF) nebo Modelu ovladačů systému Windows (WDM), můžou vyhodnocovat metody řízení rozhraní ACPI pomocí žádostí o řízení zařízení. Počínaje Systémem Windows 8 můžou ovladače uživatelského režimu, které splňují požadavky rozhraní UMDF (User-Mode Driver Framework), používat žádosti o řízení zařízení k vyhodnocení metod řízení ACPI. Ovladač obvykle vyhodnocuje metody řízení AKTI pro spuštění nebo konfiguraci funkcí specifických pro platformu. Ovladač může vyhodnotit kontrolní metody ACPI v rámci oboru názvů objektu fyzického zařízení (PDO), pro který je načten. U ovladačů načtených do zásobníku zařízení s výčtem ACPI je ovladač ACPI vždy ovladačem sběrnice, který vytvořil a provozuje PDO v zásobníku zařízení. Tato funkce zahrnuje vyhodnocení metod řízení, které jsou podporovány podřízenými objekty, které jsou potomky nadřazeného zařízení.

Ovladač vyhodnocuje kontrolní metody odesláním jednoho z následujících IRP_MJ_DEVICE_CONTROL požadavků na zařízení.

• IOCTL_ACPI_EVAL_METHOD

  Tento požadavek synchronně vyhodnocuje řídicí metodu podporovanou zařízením, do kterého se požadavek odesílá. Chcete-li použít toto IOCTL, ovladač pro zařízení poskytuje vyrovnávací paměti argumentů pro vstupní a výstupní metody, název metody a objekt události čekající na dokončení požadavku. Metoda musí být okamžitým podřízeným objektem v oboru názvů ACPI zařízení, do nějž se požadavek odešle.

• IOCTL_ACPI_ASYNC_EVAL_METHOD

  Tento požadavek asynchronně vyhodnocuje řídicí metodu podporovanou zařízením, do kterého se požadavek odešle. Pro použití tohoto IOCTL ovladač zařízení poskytuje vyrovnávací paměti pro argumenty vstupní a výstupní metody, název metody a rutinu IoCompletion, kterou správce vstupně-výstupních operací volá po dokončení požadavku všemi ovladači nižší úrovně. Metoda musí být okamžitým podřízeným objektem v oboru názvů ACPI zařízení, do kterého se požadavek odešle.

• IOCTL_ACPI_EVAL_METHOD_EX

  Tento požadavek synchronně vyhodnocuje řídicí metodu podporovanou zařízením nebo podřízeným objektem zařízení, do kterého se požadavek odešle. Chcete-li použít tento příkaz IOCTL, ovladač zařízení poskytuje vyrovnávací paměti pro vstupní a výstupní argumenty metody, cestu a název kontrolní metody v ACPI oboru názvů zařízení a objekt události, který čeká na dokončení žádosti.

• IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

  Tento požadavek asynchronně vyhodnocuje řídicí metodu, která je podporována zařízením nebo podřízeným objektem zařízení, do kterého se požadavek odešle. Chcete-li použít toto IOCTL, ovladač pro zařízení poskytuje vyrovnávací paměti pro argumenty vstupní a výstupní metody, cestu a název řídicí metody v oboru názvů ACPI zařízení a rutinu IoCompletion, kterou správce vstupně-výstupních operací volá poté, co všechny ovladače nižší úrovně dokončily požadavek.

Další informace o synchronním vyhodnocení kontrolních metod ACPI naleznete v tématu Synchronní vyhodnocení metod řízení ACPI. Další informace o tom, jak asynchronně vyhodnotit metody řízení ACPI, najdete v tématu IOCTL_ACPI_ASYNC_EVAL_METHOD a IOCTL_ACPI_ASYNC_EVAL_METHOD_EX.

Aby ovladač zařízení vyhodnotil metodu řízení, která není okamžitým podřízeným objektem zařízení, musí ovladač zadat cestu a název metody v oboru názvů ACPI zařízení. Systém Windows podporuje žádost o IOCTL_ACPI_ENUM_CHILDREN , kterou ovladač zařízení může použít k vytvoření výčtu následujících objektů, a pomáhá tak získat cestu a název podřízených objektů zařízení:

• Zařízení a jeho přímá podřízená zařízení.

• Zařízení a všechna jeho potomková zařízení.

• Podřízené objekty zadaného názvu v oboru názvů ACPI zařízení, zejména včetně kontrolních metod.

Pro informace o tom, jak vytvořit výčet zařízení a metod ve jmenném prostoru zařízení, viz Výčet podřízených zařízení a kontrolních metod.

Informace o systémových makrech, která ovladač může použít k vyhodnocení kontrolních metod, naleznete v tématu Makra metody řízení.

Další informace o zařízeních ACPI, metodách řízení a oborech názvů najdete v části Advanced Configuration and Power Interface Specification.