ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX 구조체(acpiioct.h)

ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX 구조는 IOCTL_ACPI_EVAL_METHOD_EX 요청 및 IOCTL_ACPI_ASYNC_EVAL_METHOD_EX 요청에 대한 입력으로 사용됩니다. 구조체는 ACPI 네임스페이스에 있는 컨트롤 메서드의 경로와 이름과 ACPI_METHOD_ARGUMENT 구조체의 입력 인수 배열을 제공합니다.

구문

typedef struct _ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX {
  ULONG                   Signature;
  CHAR                    MethodName[256];
  ULONG                   Size;
  ULONG                   ArgumentCount;
  ACPI_METHOD_ARGUMENT_V1 Argument[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_EX;

구성원

Signature

ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX 설정해야 하는 확장된 복합 입력 버퍼의 서명입니다.

MethodName

ACPI 네임스페이스에 있는 컨트롤 메서드의 경로와 이름을 포함하는 NULL로 종료된 ASCII 문자열입니다. NULL 종결자를 포함하여 문자열에 포함될 수 있는 최대 문자 수는 256자입니다.

컨트롤 메서드의 경로 및 이름을 제공하는 방법에 대한 자세한 내용은 이 항목의 뒷부분에 있는 설명 섹션을 참조하세요.

Size

Argument 배열에 포함된 바이트 수입니다.

ArgumentCount

Argument 배열에 포함된 가변 길이 ACPI_METHOD_ARGUMENT 구조체의 수입니다. 인수 배열은 최대 7개의 인수 구조를 보유할 수 있습니다.

Argument

ACPI_METHOD_ARGUMENT 구조체의 배열입니다.

설명

디바이스의 드라이버는 IOCTL_ACPI_EVAL_METHOD_EX 요청 또는 IOCTL_ACPI_ASYNC_EVAL_METHOD_EX 요청을 사용하여 디바이스의 하위 자식 개체인 제어 메서드를 평가할 수 있습니다. 메서드가 복잡한 인수 배열을 사용하는 경우 이러한 요청은 다음과 같이 입력 ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX 구조를 사용합니다.

• 서명을 ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX 설정합니다.
• MethodName을 ACPI 네임스페이스의 컨트롤 메서드에 대한 전체 경로 및 이름 또는 평가 요청이 전송되는 디바이스를 기준으로 메서드의 경로 및 이름을 제공하는 NULL로 끝나는 문자열로 설정합니다.

  예를 들어 요청이 ACPI 네임스페이스 루트의 직속 자식인 'ABCD'라는 디바이스로 전송되고, 'ABCD' 디바이스는 'CHLD'라는 자식 디바이스를 지원하고, 'CHLD' 디바이스는 '_FOO'라는 메서드를 지원한다고 가정합니다. 이 경우 평가 요청은 '\ABCD 중 하나를 제공할 수 있습니다. acPI 네임스페이스에 있는 컨트롤 메서드의 정규화된 경로 및 이름인 CHLD._FOO,' 또는 ACPI 네임스페이스의 'ABCD' 디바이스를 기준으로 하는 컨트롤 메서드의 경로 및 이름인 'CHLD._FOO'입니다.

  ACPI 네임스페이스에서 컨트롤 메서드의 정규화된 경로 및 이름을 가져오는 방법에 대한 자세한 내용은 자식 디바이스 및 컨트롤 메서드 열거를 참조하세요.

• 크기 는 인수 배열의 바이트 수로 설정됩니다.
• ArgumentCount 는 인수 배열의 인수 수로 설정됩니다.
• 인수 는 ACPI_METHOD_ARGUMENT 구조체의 배열로 설정됩니다.

For more information about how to use this structure, see ACPI 컨트롤 메서드 평가

요구 사항

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

참고 항목

ACPI_METHOD_ARGUMENT

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX