estrutura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX (acpiioct.h)
A estrutura de ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX é usada como entrada para uma solicitação de IOCTL_ACPI_EVAL_METHOD_EX e para uma solicitação de IOCTL_ACPI_ASYNC_EVAL_METHOD_EX. A estrutura fornece o caminho e o nome de um método de controle em um namespace ACPI e um argumento de entrada que é uma cadeia de caracteres ASCII.
Sintaxe
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;
Membros
Signature
A assinatura de um buffer de entrada de cadeia de caracteres estendida que deve ser definida como ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX.
MethodName[256]
Uma cadeia de caracteres ASCII terminada em NULL que contém o caminho e o nome de um método de controle em um namespace ACPI. O número máximo de caracteres que a cadeia de caracteres pode conter, incluindo um terminador NULL, é 256. Para obter mais informações sobre como fornecer o caminho e o nome de um método de controle, consulte a seção Comentários mais adiante neste tópico.
StringLength
O número de caracteres ASCII na matriz de caracteres fornecida pelo String.
String[ANYSIZE_ARRAY]
Uma matriz de caracteres ASCII que contém o número de caracteres especificado por stringLength. A matriz de caracteres não inclui um terminador NULL.
Observações
Um driver para um dispositivo pode usar uma solicitação IOCTL_ACPI_EVAL_METHOD_EX ou uma solicitação IOCTL_ACPI_ASYNC_EVAL_METHOD_EX para avaliar um método de controle que é um objeto filho descendente do dispositivo. Se o método usa um único argumento de entrada de cadeia de caracteres, essas solicitações levam uma estrutura de entrada ACPI_EVAL_INPUT_BUFFER_STRING_EX da seguinte maneira:
- Defina de Assinatura como ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX.
-
Defina MethodName para uma cadeia de caracteres terminada em NULL que fornece o caminho e o nome completos para um método de controle no namespace ACPI ou o caminho e o nome do método que é relativo ao dispositivo ao qual a solicitação de avaliação é enviada.
Por exemplo, suponha que uma solicitação seja enviada a um dispositivo chamado 'ABCD', que é um filho imediato da raiz de um namespace ACPI, que o dispositivo 'ABCD' dá suporte a um dispositivo filho chamado 'CHLD', e que o dispositivo 'CHLD' dá suporte a um método chamado '_FOO'. Nesse caso, a solicitação de avaliação pode fornecer '\ABCD. CHLD._FOO', que é o caminho totalmente qualificado e o nome do método de controle no namespace ACPI, ou "CHLD._FOO", que é o caminho e o nome do método de controle relativo ao dispositivo 'ABCD' no namespace ACPI.
Para obter mais informações sobre como obter o caminho totalmente qualificado e o nome de um método de controle em um namespace ACPI, consulte Enumerando dispositivos filho e métodos de controle.
- Defina StringLength com o número de caracteres em de cadeia de caracteres.
- Defina cadeia de caracteres para a cadeia de caracteres de entrada.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista e versões posteriores do Windows. |
| cabeçalho | acpiioct.h (include Acpiioct.h) |