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;

Members

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.

Commenti

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 MethodName 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.

  • Le dimensioni sono impostate sul numero di byte nella matrice Argument .
  • ArgumentCount è impostato sul numero di argomenti nella matrice Argument .
  • L'argomento è impostato su una matrice di strutture ACPI_METHOD_ARGUMENT.
Per altre informazioni sull'utilizzo di questa struttura, vedere Valutazione dei metodi di controllo ACPI.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista e versioni successive di Windows.
Intestazione acpiioct.h (include Acpiioct.h)

Vedi anche

ACPI_METHOD_ARGUMENT

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX