ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX 구조체(acpiioct.h)

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

구문

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX {
  ULONG   Signature;
  CHAR    MethodName[256];
  ULONG64 IntegerArgument;
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX;

구성원

Signature

ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EX 설정해야 하는 확장 정수 입력 버퍼의 서명입니다.

MethodName

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

IntegerArgument

컨트롤 메서드에 입력으로 전달되는 ULONG64 형식의 인수 값입니다.

설명

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

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

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

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

  • IntegerArgument를 입력 정수 값으로 설정합니다.
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