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의 문자 수로 설정합니다.
  • 문자열을 입력 문자열로 설정합니다.
이 구조를 사용하는 방법에 대한 자세한 내용은 ACPI 제어 메서드 평가를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows.
머리글 acpiioct.h(Acpiioct.h 포함)

추가 정보

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX