ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX 구조체(acpiioct.h)
ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX 구조는 IOCTL_ACPI_EVAL_METHOD_EX 요청 및 IOCTL_ACPI_ASYNC_EVAL_METHOD_EX요청에 대한 입력으로 사용됩니다. 구조체는 ACPI 네임스페이스에 있는 컨트롤 메서드의 경로와 이름과 ASCII 문자열인 입력 인수를 제공합니다.
구문
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;
멤버
Signature
ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX 설정해야 하는 확장 문자열 입력 버퍼의 서명입니다.
MethodName[256]
ACPI 네임스페이스에 있는 컨트롤 메서드의 경로와 이름을 포함하는 NULL로 끝나는 ASCII 문자열입니다. NULL 종결자를 포함하여 문자열에 포함될 수 있는 최대 문자 수는 256자입니다. 컨트롤 메서드의 경로와 이름을 제공하는 방법에 대한 자세한 내용은 이 항목의 뒷부분에 있는 설명 섹션을 참조하세요.
StringLength
String에서 제공하는 문자 배열의 ASCII 문자 수입니다.
String[ANYSIZE_ARRAY]
StringLength에서 지정한 문자 수를 포함하는 ASCII 문자 배열입니다. 문자 배열에는 NULL 종결자가 포함되지 않습니다.
설명
디바이스용 드라이버는 IOCTL_ACPI_EVAL_METHOD_EX 요청 또는 IOCTL_ACPI_ASYNC_EVAL_METHOD_EX 요청을 사용하여 디바이스의 하위 자식 개체인 제어 메서드를 평가할 수 있습니다. 메서드가 단일 문자열 입력 인수를 사용하는 경우 이러한 요청은 다음과 같이 입력 ACPI_EVAL_INPUT_BUFFER_STRING_EX 구조를 사용합니다.
- 서명을 ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX 설정합니다.
-
MethodName을 ACPI 네임스페이스의 컨트롤 메서드에 대한 전체 경로와 이름 또는 평가 요청이 전송되는 디바이스를 기준으로 하는 메서드의 경로 및 이름을 제공하는 NULL로 끝나는 문자열로 설정합니다.
예를 들어 요청이 ACPI 네임스페이스 루트의 직속 자식인 'ABCD'라는 디바이스로 전송되고, 'ABCD' 디바이스가 'CHLD'라는 자식 디바이스를 지원하고 , 'CHLD' 디바이스가 '_FOO'라는 메서드를 지원한다고 가정합니다. 이 경우 평가 요청은 '\ABCD 중 하나를 제공할 수 있습니다. acPI 네임스페이스에 있는 컨트롤 메서드의 정규화된 경로 및 이름인 CHLD._FOO,' 또는 ACPI 네임스페이스의 'ABCD' 디바이스를 기준으로 하는 제어 메서드의 경로와 이름인 'CHLD._FOO'입니다.
ACPI 네임스페이스에서 컨트롤 메서드의 정규화된 경로와 이름을 가져오는 방법에 대한 자세한 내용은 자식 디바이스 열거 및 제어 메서드를 참조하세요.
- StringLength를 String의 문자 수로 설정합니다.
- 문자열을 입력 문자열로 설정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows. |
| 머리글 | acpiioct.h(Acpiioct.h 포함) |