structure PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pepfx.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 de 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 l’état de cette requête. Définissez ce membre sur STATUS_SUCCESS si le PEP a réussi à fournir la liste demandée des ressources. Définissez la valeur STATUS_BUFFER_TOO_SMALL pour indiquer que la mémoire tampon de sortie n’est pas suffisamment grande pour contenir la liste des ressources.
[in, BiosResourcesSize
Lors de l’entrée, la taille, en octets, de la mémoire tampon allouée pour les BiosResources membre. Cette taille de mémoire tampon inclut toutes les données associées susceptibles de suivre ce membre.
Si cette mémoire tampon n’est pas suffisamment grande pour contenir la structure ACPI_METHOD_ARGUMENT et ses données associées, le pep remplace la valeur d’entrée de BiosResourcesSize avec 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 de ressources demandée. 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 la mémoire tampon spécifiée par BiosResourcesSize inclut à la fois la structure ACPI_METHOD_ARGUMENT et les éléments de tableau Data qui suivent cette structure.
Remarques
Cette structure est utilisée par la notification PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES. Les RequestFlags, BiosResourcesSizeet BiosResources membres de la structure contiennent des valeurs d’entrée fournies par l’infrastructure de gestion de l’alimentation Windows (PoFx) lorsque cette notification est envoyée. Si l'BiosResourcesSize valeur d’entrée 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 avec la taille requise et définit le membre Status sur STATUS_BUFFER_TOO_SMALL. En réponse, PoFx essaie 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 10. |
| d’en-tête | pepfx.h (include Pep_x.h) |