struttura PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pep_x.h)

La struttura PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES contiene un elenco di risorse non elaborate necessarie per controllare la potenza del dispositivo.

Sintassi

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;

Members

[in] DeviceHandle

Valore PEPHANDLE che identifica la registrazione del dispositivo per i servizi ACPI. Il plug-in di estensione della piattaforma (PEP) ha fornito questo handle in risposta a una notifica PEP_NOTIFY_ACPI_REGISTER_DEVICE precedente.

[in] RequestFlags

Set di flag di input. Non sono attualmente definiti flag per questo membro, che è sempre impostato su PEP_ACPI_QDCR_FLAG_NONE (0x0).

[out] Status

Valore NTSTATUS che indica lo stato della query. Impostare questo membro su STATUS_SUCCESS se il PEP è riuscito a fornire l'elenco richiesto di risorse. Impostare su STATUS_BUFFER_TOO_SMALL per indicare che il buffer di output non è sufficientemente grande da contenere l'elenco di risorse.

[in, BiosResourcesSize

In input, le dimensioni, in byte, del buffer allocato per il membro BiosResources . Questa dimensione del buffer include tutti i dati associati che potrebbero seguire questo membro.

Se questo buffer non è sufficientemente grande da contenere la struttura ACPI_METHOD_ARGUMENT e i dati associati, il PEP sovrascrive il valore di input di BiosResourcesSize con le dimensioni necessarie e imposta il membro Status su STATUS_BUFFER_TOO_SMALL.

[in] BiosResources[ANYSIZE_ARRAY]

Buffer di output in cui pep scrive una struttura ACPI_METHOD_ARGUMENT che contiene l'elenco di risorse richieste. Il membro Data di questa struttura è il primo membro di una matrice che potrebbe estendersi oltre la fine della struttura. Le dimensioni del buffer specificate da BiosResourcesSize includono sia la struttura ACPI_METHOD_ARGUMENT che gli elementi matrice di dati che seguono questa struttura.

Commenti

Questa struttura viene utilizzata dalla notifica PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES . I membri RequestFlags, BiosResourcesSize e BiosResources della struttura contengono valori di input forniti dal framework di risparmio energia di Windows (PoFx) quando questa notifica viene inviata. Se il valore di input BiosResourcesSize è troppo piccolo, il PEP deve sovrascrivere questo valore. Il membro Status contiene un valore di output che il PEP scrive in questa struttura in risposta alla notifica.

Se il valore di input specificato nel membro BiosResourcesSize è minore delle dimensioni necessarie, il PEP sovrascrive il valore di input BiosResourcesSize con le dimensioni necessarie e imposta il membro Status su STATUS_BUFFER_TOO_SMALL. In risposta, PoFx tenterà di allocare un buffer delle dimensioni necessarie e invierà una seconda notifica PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES al PEP per questo dispositivo.

Requisiti

Vedi anche

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE