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[256]

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

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

Size

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

ArgumentCount

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

Argument[ANYSIZE_ARRAY]

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

  • 크기 는 Argument 배열의 바이트 수로 설정됩니다.
  • ArgumentCount 는 Argument 배열의 인수 수로 설정됩니다.
  • 인수 는 ACPI_METHOD_ARGUMENT 구조체의 배열로 설정됩니다.
이 구조를 사용하는 방법에 대한 자세한 내용은 ACPI 제어 메서드 평가를 참조하세요.

요구 사항

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

추가 정보

ACPI_METHOD_ARGUMENT

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX