IOCTL_HPMI_QUERY_CAPABILITIES IOCTL(hpmi.h)

아티클
02/06/2022
읽는 데 3분 걸림

[일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 명시적 또는 묵시적 보증을 하지 않습니다.]

IOCTL_HPMI_QUERY_CAPABILITIES 명령은 HPMI에서 지원하는 쿼리 기능 및 HPMI에서 요청한 Windows 서비스로 전송됩니다. Windows 새 HPMI 드라이버 인스턴스가 검색된 후 이 IOCL을 HPMI에 한 번 발급합니다.

중요 예비 정보

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

IRP(I/O 요청 패킷)의 ASSOCIATedIrp.SystemBuffer 멤버는 요청에 대한 입력 버퍼 및 출력 버퍼로 사용되는 초기자 할당 버퍼를 가리킵니다. 입력 시 이 버퍼에는 버전이 유효한 값으로 설정된 HPMI_QUERY_CAPABILITIES 구조체가 포함됩니다.

입력 버퍼 길이

IRP의 현재 I/O 스택 위치(IO_STACK_LOCATION)의 Parameters.DeviceIoControl.InputBufferLength 멤버는 ASSOCIATedIrp.SystemBuffer 멤버가 가리키는 버퍼의 크기(바이트)로 설정됩니다. 이 크기는 HPMI_QUERY_CAPABILITIES 구조체의 크기보다 크거나 같아야 합니다. 그렇지 않으면 오류 상태가 STATUS_INVALID_PARAMETER 요청이 실패합니다.

출력 버퍼

요청이 성공적으로 완료되면 AssociatedIrp.SystemBuffer 멤버가 가리키는 버퍼에 요청된 HPMI 기능 정보가 포함됩니다. 이 버퍼의 시작 부분에는 버퍼에 있는 정보의 형식과 크기를 나타내는 HPMI_QUERY_CAPABILITIES_RESPONSE 구조체가 있습니다.

출력 버퍼 길이

IRP의 현재 I/O 스택 위치의 Parameters.DeviceIoControl.OutputBufferLength 멤버는 ASSOCIATedIrp.SystemBuffer 멤버가 가리키는 버퍼의 크기(바이트)로 설정됩니다. 요청이 성공하려면 이 크기가 HPMI_QUERY_CAPABILITIES_RESPONSE 설명된 HPMI 기능을 포함할 만큼 커야 합니다. 그렇지 않으면 오류 상태 STATUS_BUFFER_TOO_SMALL 요청이 실패합니다.

입력/출력 버퍼

TBD

입력/출력 버퍼 길이

TBD

상태 블록

요청이 성공하면 Irp->IoStatus.Status가 STATUS_SUCCESS 설정됩니다. 그렇지 않으면 NTSTATUS 코드로 적절한 오류 조건에 대한 상태(예: STATUS_INVALID_PARAMETER)입니다.

설명

IOCTL_HPMI_QUERY_CAPABILITIES 요청은 파워 미터의 HPMI 기능 또는 자산 정보를 쿼리합니다. 입력 HPMI_QUERY_CAPABILITIES 구조체 값은 반환할 기능 정보의 형식을 지정합니다. 출력 버퍼의 데이터 형식 및 내용은 요청된 데이터에 따라 달라집니다.

이 IOCTL은 여러 번 발급될 수 있으며 HPMI는 동일한 응답으로 응답해야 합니다.
모든 항목에 대한 응답으로 HPMI_QUERY_CAPABILITIES_RESPONSE 정보
이후 IOCTL 호출.

요구 사항


지원되는 최소 클라이언트	Windows 10 버전 1709 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
헤더	hpmi.h(Hpmi.h 포함)