Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IOCTL_PMI_SET_CONFIGURATION Anforderung legt die Konfigurationsdaten für einen Stromzähler fest.
Hauptcode
Eingabepuffer
Der AssociatedIrp.SystemBuffer Mitglied des I/O-Anforderungspakets (IRP) verweist auf einen vom Initiator zugewiesenen Eingabepuffer, der eine PMI_CONFIGURATION Struktur enthält. Diese Struktur enthält die Konfigurationsdaten.
Eingabepufferlänge
Die Parameters.DeviceIoControl.InputBufferLength Member der aktuellen I/O-Stapelposition (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 Größe von(PMI_CONFIGURATION) sein, oder die Anforderung schlägt mit einem Fehlerstatus von STATUS_BUFFER_TOO_SMALL fehl.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
Das Information Members wird auf die Größe einer PMI_CONFIGURATION Struktur in Byte festgelegt.
Der Status- Member ist auf einen der folgenden Werte festgelegt:
STATUS_BUFFER_TOO_SMALL
Der Parameters.DeviceIoControl.OutputBufferLength Member des IRP- ist kleiner als die Größe einer PMI_CONFIGURATION-Struktur in Byte.
STATUS_SUCCESS
Der WDM-Treiber, der die PMI-Schnittstelle unterstützt, hat die IOCTL-Anforderung erfolgreich abgeschlossen.
Bemerkungen
Die IOCTL_PMI_SET_CONFIGURATION Anforderung legt die Konfigurationsparameter für den Leistungszähler fest. Das AssociatedIrp.SystemBuffer Element des IRP verweist auf einen Puffer, der eine PMI_CONFIGURATION Struktur enthält. Das ConfigurationType Mitglied dieser Struktur enthält Informationen zum Typ der PMI-Konfigurationsdaten, die im Leistungszähler festgelegt werden sollen.
Nur PMI-Konfigurationsdaten, die vom Power meter mit Lese-/Schreibberechtigungen unterstützt werden, können mithilfe einer festgelegten Anforderung von IOCTL_PMI_SET_CONFIGURATIONgeändert werden. Eine set request of IOCTL_PMI_SET_CONFIGURATION to change read-only PMI configuration data will fail, and the data will not be changed on the power meter.
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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7, Windows Server 2008 R2 und höheren Versionen von Windows-Betriebssystemen. |
| Header- | pmi.h (include Pmi.h) |