WdfWmiInstanceDeregister function (wdfwmi.h)

[Applies to KMDF only]

The WdfWmiInstanceDeregister method deregisters a specified instance of a WMI data provider from the system's WMI service.

Syntax

void WdfWmiInstanceDeregister(
  [in] WDFWMIINSTANCE WmiInstance
);

Parameters

[in] WmiInstance

A handle to a WMI instance object that the driver obtained from a previous call to WdfWmiInstanceCreate.

Return value

None

Remarks

A bug check occurs if the driver supplies an invalid object handle.

For more information about the WdfWmiInstanceDeregister method, see Registering Provider Instances. For more information about WMI, see Supporting WMI in Framework-Based Drivers.

WdfWmiInstanceRegister deregisters the provider instance synchronously (that is, before returning) if it is called at IRQL = PASSIVE_LEVEL and asynchronously if it is called at IRQL > PASSIVE_LEVEL.

Examples

The following code example deregisters a specified instance of a WMI data provider from the system's WMI service.

WdfWmiInstanceDeregister(wmiInstance);

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Header wdfwmi.h (include Wdf.h)
Library Wdf01000.sys (see Framework Library Versioning.)
IRQL <=DISPATCH_LEVEL
DDI compliance rules DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

See also

WdfWmiInstanceCreate

WdfWmiInstanceRegister