피드백

ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX 구조체(acpiioct.h)

  • 아티클
  • 읽는 데 3분 걸림

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

ACPI 네임스페이스에 있는 컨트롤 메서드의 경로와 이름을 포함하는 NULL로 종료된 ASCII 문자열입니다. NULL 종결자를 포함하여 문자열에 포함될 수 있는 최대 문자 수는 256자입니다. 컨트롤 메서드의 경로 및 이름을 제공하는 방법에 대한 자세한 내용은 이 항목의 뒷부분에 있는 설명 섹션을 참조하세요.

StringLength

String에서 제공하는 문자 배열의 ASCII 문자 수입니다.

String

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의 문자 수로 설정합니다.
  • 문자열을 입력 문자열로 설정합니다.
For more information about how to use this structure, see ACPI 컨트롤 메서드 평가

요구 사항

   
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows.
헤더 acpiioct.h(Acpiioct.h 포함)

참고 항목

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX