structure PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pep_x.h)
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) |