struttura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX (acpiioct.h)
La struttura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_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 che è una stringa ASCII.
Sintassi
typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG StringLength;
UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX;
Membri
Signature
Firma di un buffer di input della stringa estesa che deve essere impostato su ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_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.
StringLength
Numero di caratteri ASCII nella matrice di caratteri forniti da String.
String[ANYSIZE_ARRAY]
Matrice di caratteri ASCII che contiene il numero di caratteri specificato da StringLength. La matrice di caratteri non include un carattere di terminazione NULL.
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 stringa, queste richieste accettano una struttura di input ACPI_EVAL_INPUT_BUFFER_STRING_EX come indicato di seguito:
- Impostare Firma su ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_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 StringLength sul numero di caratteri in String.
- Impostare stringa sulla stringa di input.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista e versioni successive di Windows. |
| intestazione | acpioct.h (include Acpiioct.h) |