structure PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pep_x.h)

  • Article

La structure PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES contient une liste de ressources brutes nécessaires pour contrôler l’alimentation de l’appareil.

Syntaxe

typedef struct _PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES {
  [in]      PEPHANDLE            DeviceHandle;
  [in]      ULONG                RequestFlags;
  [out]     NTSTATUS             Status;
  [in, out] SIZE_T               BiosResourcesSize;
            ACPI_METHOD_ARGUMENT BiosResources[ANYSIZE_ARRAY];
} PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES, *PPEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES;

Membres

[in] DeviceHandle

Valeur PEPHANDLE qui identifie l’inscription de l’appareil pour les services ACPI. Le plug-in d’extension de plateforme (PEP) a fourni ce handle en réponse à une notification PEP_NOTIFY_ACPI_REGISTER_DEVICE précédente.

[in] RequestFlags

Ensemble d’indicateurs d’entrée. Aucun indicateur n’est actuellement défini pour ce membre, qui est toujours défini sur PEP_ACPI_QDCR_FLAG_NONE (0x0).

[out] Status

Valeur NTSTATUS qui indique la status de cette requête. Définissez ce membre sur STATUS_SUCCESS si le PEP a réussi à fournir la liste des ressources demandée. Définissez sur STATUS_BUFFER_TOO_SMALL pour indiquer que la mémoire tampon de sortie n’est pas assez grande pour contenir la liste des ressources.

[in, BiosResourcesSize

En entrée, la taille, en octets, de la mémoire tampon allouée pour le membre BiosResources . Cette taille de mémoire tampon inclut toutes les données associées qui peuvent suivre ce membre.

Si cette mémoire tampon n’est pas assez grande pour contenir la structure ACPI_METHOD_ARGUMENT et les données associées, le PEP remplace la valeur d’entrée de BiosResourcesSize par la taille requise et définit le membre Status sur STATUS_BUFFER_TOO_SMALL.

[in] BiosResources[ANYSIZE_ARRAY]

Mémoire tampon de sortie dans laquelle le PEP écrit une structure ACPI_METHOD_ARGUMENT qui contient la liste des ressources demandées. Le membre Data de cette structure est le premier membre d’un tableau qui peut s’étendre au-delà de la fin de la structure. La taille de mémoire tampon spécifiée par BiosResourcesSize inclut la structure ACPI_METHOD_ARGUMENT et tous les éléments de tableau de données qui suivent cette structure.

Remarques

Cette structure est utilisée par la notification PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES . Les membres RequestFlags, BiosResourcesSize et BiosResources de la structure contiennent des valeurs d’entrée fournies par l’infrastructure de gestion de l’alimentation Windows (PoFx) lors de l’envoi de cette notification. Si la valeur d’entrée BiosResourcesSize est trop petite, le PEP doit remplacer cette valeur. Le membre Status contient une valeur de sortie que le PEP écrit dans cette structure en réponse à la notification.

Si la valeur d’entrée spécifiée dans le membre BiosResourcesSize est inférieure à la taille requise, le PEP remplace la valeur d’entrée BiosResourcesSize par la taille requise et définit le membre Status sur STATUS_BUFFER_TOO_SMALL. En réponse, PoFx essaiera d’allouer une mémoire tampon de la taille requise et d’envoyer une deuxième notification PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES au PEP pour cet appareil.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge à partir de Windows 10.
En-tête pep_x.h (include Pep_x.h)

Voir aussi

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE