struttura ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX (acpiioct.h)
La struttura ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX viene usata come input per una richiesta di IOCTL_ACPI_EVAL_METHOD_EX e per una richiesta di IOCTL_ACPI_ASYNC_EVAL_METHOD_EX. La struttura fornisce il percorso e il nome di un metodo di controllo in uno spazio dei nomi ACPI e un argomento di input di tipo ULONG64.
Sintassi
typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG64 IntegerArgument;
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX;
Membri
Signature
Firma di un buffer di input integer esteso, che deve essere impostato su ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EX.
MethodName[256]
Stringa ASCII con terminazione NULL contenente il percorso e il nome di un metodo di controllo in uno spazio dei nomi ACPI. Il numero massimo di caratteri che la stringa può contenere, incluso un carattere di terminazione NULL, è 256. Per altre informazioni su come specificare il percorso e il nome di un metodo di controllo, vedere la sezione Osservazioni più avanti in questo argomento.
IntegerArgument
Valore dell'argomento di tipo ULONG64 passato come input al metodo di controllo.
Osservazioni
Un driver per un dispositivo può usare una richiesta di IOCTL_ACPI_EVAL_METHOD_EX o una richiesta di IOCTL_ACPI_ASYNC_EVAL_METHOD_EX per valutare un metodo di controllo che è un oggetto figlio discendente del dispositivo. Se il metodo accetta un singolo argomento di input integer, queste richieste accettano una struttura di input ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX come indicato di seguito:
- Impostare Firma su ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EX.
-
Impostare NomeMetodo su una stringa con terminazione NULL che fornisce il percorso completo e il nome a un metodo di controllo nello spazio dei nomi ACPI oppure il percorso e il nome del metodo relativo al dispositivo a cui viene inviata la richiesta di valutazione.
Si supponga, ad esempio, che una richiesta venga inviata a un dispositivo denominato "ABCD", che è un figlio immediato della radice di uno spazio dei nomi ACPI, che il dispositivo "ABCD" supporti un dispositivo figlio denominato "CHLD" e che il dispositivo "CHLD" supporti un metodo denominato "_FOO". In questo caso, la richiesta di valutazione può fornire '\ABCD. CHLD._FOO, ovvero il percorso completo e il nome del metodo di controllo nello spazio dei nomi ACPI o "CHLD._FOO", ovvero il percorso e il nome del metodo di controllo relativo al dispositivo "ABCD" nello spazio dei nomi ACPI.
Per altre informazioni su come ottenere il percorso completo e il nome di un metodo di controllo in uno spazio dei nomi ACPI, vedere enumerazione di dispositivi figlio e metodi di controllo.
- Impostare IntegerArgument sul valore intero di input.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista e versioni successive di Windows. |
| intestazione | acpioct.h (include Acpiioct.h) |