struttura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 (acpiioct.h)

La struttura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING viene usata come input per una richiesta di IOCTL_ACPI_EVAL_METHOD e per una richiesta di IOCTL_ACPI_ASYNC_EVAL_METHOD . La struttura fornisce il nome di un metodo di controllo e un argomento di input che è una stringa ASCII.

Sintassi

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 {
  ULONG Signature;
  union {
    UCHAR MethodName[4];
    ULONG MethodNameAsUlong;
  } DUMMYUNIONNAME;
  ULONG StringLength;
  UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING;

Members

Signature

Firma di un buffer di input stringa, che deve essere impostato su ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.

DUMMYUNIONNAME

DUMMYUNIONNAME.MethodName[4]

Questo membro dell'unione è una matrice di caratteri ASCII a quattro elementi che contiene il nome del metodo. Ad esempio, 'ABCD'.

DUMMYUNIONNAME.MethodNameAsUlong

Questo membro di unione è una variabile tipizzata ULONG che contiene il nome del metodo nel formato (ULONG) ('DCBA'), dove il nome del metodo è la matrice di caratteri ASCII a quattro elementi 'ABCD'.

StringLength

Numero di caratteri ASCII nella matrice di caratteri forniti da String.

String[ANYSIZE_ARRAY]

Stringa di caratteri ASCII contenente il numero di caratteri specificato da StringLength. La stringa non include un carattere di terminazione NULL.

Commenti

Se un dispositivo supporta un metodo di controllo denominato ABCD che accetta una stringa ASCII come input, un driver per il dispositivo può valutare il metodo inviando una richiesta di IOCTL_ACPI_EVAL_METHOD o una richiesta di IOCTL_ACPI_ASYNC_EVAL_METHOD al dispositivo e impostando i membri della struttura di input ACPI_EVAL_INPUT_BUFFER come segue:

• Impostare Firma su ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.
• Impostare MethodName su 'ABCD' o MethodNameAsUlong su (ULONG)('DCBA').
• Impostare StringLength sul numero di caratteri forniti da String.
• Impostare String sulla stringa di input.

Requisiti

Vedi anche

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD