IOCTL_HPMI_QUERY_CAPABILITIES IOCTL (hpmi.h)

Artikel
02/07/2025

[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklich oder konkludent in Bezug auf die hier bereitgestellten Informationen.]

Der Befehl IOCTL_HPMI_QUERY_CAPABILITIES wird an abfragefeatures gesendet, die von HPMI und Windows-Diensten unterstützt werden, die von HPMI angefordert werden. Windows gibt diese IOCL einmal auf HPMI aus, nachdem eine neue HPMI-Treiberinstanz entdeckt wurde.

Wichtige Vorläufige Informationen

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

The AssociatedIrp.SystemBuffer member of the I/O request packet (IRP) points to an initiator-associated buffer that is used both as the input buffer and the output buffer for the request. Bei eingabe enthält dieser Puffer eine HPMI_QUERY_CAPABILITIES Struktur, in der die Version auf einen gültigen Wert festgelegt ist.

Eingabepufferlänge

Das Parameters.DeviceIoControl.InputBufferLength-Element der aktuellen I/O-Stapelposition (IO_STACK_LOCATION) des IRP wird auf die Größe in Bytes des Puffers festgelegt, auf den das AssociatedIrp.SystemBuffer-Element verweist. Diese Größe muss größer oder gleich der Größe HPMI_QUERY_CAPABILITIES Struktur sein, oder die Anforderung schlägt mit einem Fehlerstatus von STATUS_INVALID_PARAMETER fehl.

Ausgabepuffer

Wenn die Anforderung erfolgreich abgeschlossen wird, enthält der vom AssociatedIrp.SystemBuffer-Member verwiesene Puffer die angeforderten HPMI-Funktionsinformationen. Am Anfang dieses Puffers befindet sich eine HPMI_QUERY_CAPABILITIES_RESPONSE Struktur, die den Typ und die Größe der Informationen im Puffer angibt.

Länge des Ausgabepuffers

Das Parameters.DeviceIoControl.OutputBufferLength-Element der aktuellen I/O-Stapelposition des IRP wird auf die Größe in Bytes des Puffers festgelegt, auf den das AssociatedIrp.SystemBuffer-Element verweist. Damit die Anforderung erfolgreich ist, muss diese Größe groß genug sein, um die in HPMI_QUERY_CAPABILITIES_RESPONSEbeschriebene HPMI-Funktion zu enthalten. Andernfalls schlägt die Anforderung mit dem Fehlerstatus STATUS_BUFFER_TOO_SMALL fehl.

Eingabe-/Ausgabepuffer

TBD

Länge des Eingabe-/Ausgabepuffers

TBD

Statusblock

Irp->IoStatus.Status auf STATUS_SUCCESS festgelegt ist, wenn die Anforderung erfolgreich ist. Andernfalls Status der entsprechenden Fehlerbedingung als NTSTATUS- Code, z. B. STATUS_INVALID_PARAMETER.

Bemerkungen

Die IOCTL_HPMI_QUERY_CAPABILITIES Anforderung fragt die HPMI-Funktionen oder Ressourceninformationen des Stromzählers ab. Der Eingabe-HPMI_QUERY_CAPABILITIES Strukturwert gibt den Typ der funktionsinformationen an, die zurückgegeben werden sollen. Der Datentyp und der Inhalt des Ausgabepuffers variieren je nach angeforderten Daten.

Diese IOCTL kann mehrmals ausgestellt werden, HPMI muss mit demselben Antworten antworten.
Informationen in HPMI_QUERY_CAPABILITIES_RESPONSE als Antwort auf alle
nachfolgende IOCTL-Aufrufe.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 10, Version 1709 und höher, Versionen von Windows-Betriebssystemen.
Header-	hpmi.h (enthalten Hpmi.h)