EVT_WDF_WMI_INSTANCE_SET_ITEM Rückruffunktion (wdfwmi.h)
[Gilt nur für KMDF]
Die EvtWmiInstanceSetItem-Rückruffunktion eines Treibers legt ein einzelnes Element der instance Daten eines WMI-Datenanbieters auf einen Wert fest, den ein WMI-Client bereitstellt.
Syntax
EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;
NTSTATUS EvtWdfWmiInstanceSetItem(
[in] WDFWMIINSTANCE WmiInstance,
[in] ULONG DataItemId,
[in] ULONG InBufferSize,
[in] PVOID InBuffer
)
{...}
Parameter
[in] WmiInstance
Ein Handle für ein WMI-instance-Objekt.
[in] DataItemId
Ein Wert, der ein Datenelement für einen Anbieter instance identifiziert. Dieser Wert entspricht dem WmiDataId-Wert , der in der MOF-Datei des Anbieters angegeben ist.
[in] InBufferSize
Die Größe des Eingabepuffers in Bytes, auf den InBuffer verweist.
[in] InBuffer
Ein Zeiger auf den Eingabepuffer.
Rückgabewert
Die Rückruffunktion EvtWmiInstanceSetItem muss STATUS_SUCCESS zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls muss diese Funktion einen status Wert zurückgeben, für den NT_SUCCESS(status) false entspricht. Wenn der Eingabepuffer, auf den der InBuffer-Parameter verweist, zu klein ist, um alle Daten zu enthalten, die der Treiber erwartet, muss die Rückruffunktion STATUS_WMI_SET_FAILURE zurückgeben.
Hinweise
Um eine EvtWmiInstanceSetItem-Rückruffunktion zu registrieren, muss Ihr Treiber die Adresse der Funktion in einer WDF_WMI_INSTANCE_CONFIG-Struktur platzieren, bevor WdfWmiInstanceCreate aufgerufen wird.
Das Framework synchronisiert keine Aufrufe der WMI-Ereignisrückruffunktionen eines Treibers miteinander oder mit anderen Ereignisrückruffunktionen des Treibers. Wenn die Daten einer EvtWmiInstanceSetItem-Rückruffunktion dynamisch sind und für andere Rückruffunktionen freigegeben werden, kann Ihr Treiber die Warte- oder Spinsperren des Frameworks verwenden, um den Zugriff auf die Daten zu synchronisieren.
Weitere Informationen zur Rückruffunktion EvtWmiInstanceSetItem finden Sie unter Unterstützen von WMI in Framework-Based-Treibern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfwmi.h (einschließen von Wdf.h) |
| IRQL | PASSIVE_LEVEL |