PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES 구조체(pep_x.h)

  • 아티클

PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES 구조에는 디바이스에 대한 전원을 제어하는 데 필요한 원시 리소스 목록이 포함되어 있습니다.

구문

typedef struct _PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES {
  [in]      PEPHANDLE            DeviceHandle;
  [in]      ULONG                RequestFlags;
  [out]     NTSTATUS             Status;
  [in, out] SIZE_T               BiosResourcesSize;
            ACPI_METHOD_ARGUMENT BiosResources[ANYSIZE_ARRAY];
} PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES, *PPEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES;

멤버

[in] DeviceHandle

ACPI 서비스에 대한 디바이스 등록을 식별하는 PEPHANDLE 값입니다. PEP(플랫폼 확장 플러그 인)는 이전 PEP_NOTIFY_ACPI_REGISTER_DEVICE 알림에 대한 응답으로 이 핸들을 제공했습니다.

[in] RequestFlags

입력 플래그 집합입니다. 이 멤버에 대한 플래그는 현재 정의되어 있지 않으며 항상 PEP_ACPI_QDCR_FLAG_NONE(0x0)로 설정됩니다.

[out] Status

이 쿼리의 상태 나타내는 NTSTATUS 값입니다. PEP가 요청된 리소스 목록을 제공하는 데 성공한 경우 이 멤버를 STATUS_SUCCESS 설정합니다. 출력 버퍼가 리소스 목록을 포함할 만큼 크지 않음을 나타내려면 STATUS_BUFFER_TOO_SMALL 로 설정합니다.

[in, BiosResourcesSize

입력에서 BiosResources 멤버에 할당된 버퍼의 크기(바이트)입니다. 이 버퍼 크기에는 이 멤버를 따를 수 있는 연결된 데이터가 포함됩니다.

이 버퍼가 ACPI_METHOD_ARGUMENT 구조와 관련 데이터를 포함할 만큼 크지 않은 경우 PEP는 필요한 크기로 BiosResourcesSize 의 입력 값을 덮어쓰고 Status 멤버를 STATUS_BUFFER_TOO_SMALL 설정합니다.

[in] BiosResources[ANYSIZE_ARRAY]

PEP가 요청된 리소스 목록을 포함하는 ACPI_METHOD_ARGUMENT 구조를 작성하는 출력 버퍼입니다. 이 구조체의 데이터 멤버는 구조체의 끝을 지나 확장할 수 있는 배열의 첫 번째 멤버입니다. BiosResourcesSize에 지정된 버퍼 크기에는 ACPI_METHOD_ARGUMENT 구조체와 이 구조체를 따르는 모든 데이터 배열 요소가 모두 포함됩니다.

설명

이 구조체는 PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES 알림에서 사용됩니다. 구조체의 RequestFlags, BiosResourcesSize 및 BiosResources 멤버는 이 알림을 보낼 때 Windows PoFx( 전원 관리 프레임워크 )에서 제공하는 입력 값을 포함합니다. BiosResourcesSize 입력 값이 너무 작으면 PEP에서 이 값을 덮어써야 합니다. Status 멤버에는 PEP가 알림에 대한 응답으로 이 구조에 쓰는 출력 값이 포함됩니다.

BiosResourcesSize 멤버에 지정된 입력 값이 필요한 크기보다 작으면 PEP는 필요한 크기로 BiosResourcesSize 입력 값을 덮어쓰고 Status 멤버를 STATUS_BUFFER_TOO_SMALL 설정합니다. 이에 대한 응답으로 PoFx는 필요한 크기의 버퍼를 할당하고 이 디바이스의 PEP에 두 번째 PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES 알림을 보냅니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 부터 지원합니다.
머리글 pep_x.h(Pep_x.h 포함)

추가 정보

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE