struttura ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX (acpiioct.h)
La struttura ACPI_EVAL_INPUT_BUFFER_COMPLEX_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 una matrice di argomenti di input di strutture ACPI_METHOD_ARGUMENT.
Sintassi
typedef struct _ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG Size;
ULONG ArgumentCount;
ACPI_METHOD_ARGUMENT_V1 Argument[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_EX;
Membri
Signature
Firma di un buffer di input complesso esteso, che deve essere impostato su ACPI_EVAL_INPUT_BUFFER_COMPLEX_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.
Size
Numero di byte contenuti nella matrice argument.
ArgumentCount
Numero di strutture a lunghezza variabile ACPI_METHOD_ARGUMENT contenute nella matrice argument. La matrice argument può contenere un massimo di sette strutture di argomenti.
Argument[ANYSIZE_ARRAY]
Matrice di strutture ACPI_METHOD_ARGUMENT.
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 una matrice complessa di argomenti, queste richieste accettano una struttura di input ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX come indicato di seguito:
- Impostare Firma su ACPI_EVAL_INPUT_BUFFER_COMPLEX_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 rispetto 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.
- Size è impostato sul numero di byte nella matrice argument.
- argumentCount è impostato sul numero di argomenti nella matrice argument.
- argument è impostato su una matrice di strutture ACPI_METHOD_ARGUMENT.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista e versioni successive di Windows. |
| intestazione | acpioct.h (include Acpiioct.h) |