EVT_WDF_WMI_INSTANCE_SET_INSTANCE Rückruffunktion (wdfwmi.h)
[Gilt nur für KMDF]
Die EvtWmiInstanceSetInstance-Rückruffunktion eines Treibers legt alle instance Daten eines WMI-Datenanbieters auf Werte fest, die ein WMI-Client bereitstellt.
Syntax
EVT_WDF_WMI_INSTANCE_SET_INSTANCE EvtWdfWmiInstanceSetInstance;
NTSTATUS EvtWdfWmiInstanceSetInstance(
[in] WDFWMIINSTANCE WmiInstance,
[in] ULONG InBufferSize,
[in] PVOID InBuffer
)
{...}
Parameter
[in] WmiInstance
Ein Handle für ein WMI-instance-Objekt.
[in] InBufferSize
Die Größe des Eingabepuffers in Bytes, auf den InBuffer zeigt.
[in] InBuffer
Ein Zeiger auf den Eingabepuffer.
Rückgabewert
Die Rückruffunktion EvtWmiInstanceSetInstance 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) gleich FALSE ist. Wenn der Eingabepuffer, auf den der InBuffer-Parameter verweist, zu klein ist, um alle vom Treiber erwarteten Daten zu enthalten, muss die Rückruffunktion STATUS_WMI_SET_FAILURE zurückgeben.
Hinweise
Um eine EvtWmiInstanceSetInstance-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 EvtWmiInstanceSetInstance-Rückruffunktion dynamisch sind und für andere Rückruffunktionen freigegeben werden, kann Ihr Treiber die Warte- oder Drehsperren des Frameworks verwenden, um den Zugriff auf die Daten zu synchronisieren.
Weitere Informationen zur Rückruffunktion EvtWmiInstanceSetInstance finden Sie unter Unterstützung 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 |