IOCTL_PMI_SET_CONFIGURATION IOCTL (pmi.h)

Artikel
02/26/2024

Die IOCTL_PMI_SET_CONFIGURATION-Anforderung legt die Konfigurationsdaten für einen Stromzähler fest.

Hauptcode

Eingabepuffer

Der AssociatedIrp.SystemBuffer-Member des E/A-Anforderungspakets (IRP) verweist auf einen vom Initiator zugewiesenen Eingabepuffer, der eine PMI_CONFIGURATION-Struktur enthält. Diese Struktur enthält die Konfigurationsdaten.

Länge des Eingabepuffers

Der Parameters.DeviceIoControl.InputBufferLength-Member des aktuellen I/O-Stapelspeicherorts (IO_STACK_LOCATION) des IRP wird auf die Größe in Byte des Eingabepuffers festgelegt, auf den der AssociatedIrp.SystemBuffer-Member verweist. Diese Größe muss größer oder gleich sizeof(PMI_CONFIGURATION) sein, andernfalls schlägt die Anforderung mit einem Fehler status STATUS_BUFFER_TOO_SMALL fehl.

Ausgabepuffer

Keine.

Länge des Ausgabepuffers

Keine.

Statusblock

Der Information-Member wird auf die Größe einer PMI_CONFIGURATION-Struktur in Bytes festgelegt.

Das Status-Element wird auf einen der folgenden Werte festgelegt:

STATUS_BUFFER_TOO_SMALL

Das Parameters.DeviceIoControl.OutputBufferLength-Element des IRP ist kleiner als die Größe einer PMI_CONFIGURATION-Struktur in Bytes.

STATUS_SUCCESS

Der WDM-Treiber, der die PMI-Schnittstelle unterstützt, hat die IOCTL-Anforderung erfolgreich abgeschlossen.

Hinweise

Die IOCTL_PMI_SET_CONFIGURATION-Anforderung legt die Konfigurationsparameter für den Leistungszähler fest. Der AssociatedIrp.SystemBuffer-Member des IRP verweist auf einen Puffer, der eine PMI_CONFIGURATION-Struktur enthält. Das ConfigurationType-Element dieser Struktur enthält Informationen zum Typ der PMI-Konfigurationsdaten, die im Leistungsmessgerät festgelegt werden sollen.

Nur PMI-Konfigurationsdaten, die vom Stromzähler mit Lese-/Schreibberechtigungen unterstützt werden, können mithilfe einer festgelegten Anforderung von IOCTL_PMI_SET_CONFIGURATION geändert werden. Eine festgelegte Anforderung von IOCTL_PMI_SET_CONFIGURATION zum Ändern schreibgeschützter PMI-Konfigurationsdaten schlägt fehl, und die Daten werden nicht auf dem Stromzähler geändert.

Hinweis Ab Windows 7 und Windows Server 2008 R2 kann der Stromzähler auch Lese-/Schreibberechtigungen für die Budgetierungsinformationen unterstützen. Weitere Informationen finden Sie unter PMI_REPORTED_CAPABILITIES.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7, Windows Server 2008 R2 und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	pmi.h (pmi.h einschließen)