WdfWmiProviderCreate function (wdfwmi.h)
[Applies to KMDF only]
The WdfWmiProviderCreate method creates a WMI provider object that represents a WMI data block.
NTSTATUS WdfWmiProviderCreate( WDFDEVICE Device, PWDF_WMI_PROVIDER_CONFIG WmiProviderConfig, PWDF_OBJECT_ATTRIBUTES ProviderAttributes, WDFWMIPROVIDER *WmiProvider );
[in] A handle to a framework device object that will be the new provider object's parent object. The device object cannot be a control device object.
[in] A pointer to a caller-initialized WDF_WMI_PROVIDER_CONFIG structure that contains configuration information about the WMI data block.
[in, optional] A pointer to a caller-allocated WDF_OBJECT_ATTRIBUTES structure that contains driver-supplied object attributes for the new WMI provider object. (The structure's ParentObject member must be NULL.) This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.
[out] A pointer to a location that receives a handle to the new WMI provider object.
WdfWmiProviderCreate returns STATUS_SUCCESS if the operation succeeds. Otherwise, this method might return one of the following values:
||An invalid parameter was detected.|
||The size of the WDF_WMI_PROVIDER_CONFIG structure that the WmiProviderConfig parameter pointed to was incorrect.|
||There was insufficient memory to complete the operation.|
||The driver has already called WdfWmiProviderCreate for the specified device and WMI data block.|
For a list of other return values that the WdfWmiProviderCreate method might return, see Framework Object Creation Errors.
This method also might return other NTSTATUS values.
A bug check occurs if the driver supplies an invalid object handle.
Your driver must call WdfWmiProviderCreate to create a WMI provider object if the driver will create multiple instances of the provider. If the driver will create only one instance of the provider, it can call WdfWmiInstanceCreate without first calling WdfWmiProviderCreate.
A driver can call WdfWmiProviderCreate at any time, but drivers typically call WdfWmiProviderCreate from within their EvtDriverDeviceAdd callback functions.
The parent of each WMI provider object is the device's framework device object. The driver cannot change this parent, and the ParentObject member or the WDF_OBJECT_ATTRIBUTES structure must be NULL.
After a driver calls WdfWmiProviderCreate, the driver can call WdfWmiProviderGetDevice to retrieve a handle to the provider object's parent device object.
After a driver creates a WMI provider object, the driver cannot delete the object. The framework deletes a device's WMI provider objects when it deletes the framework device object that represents the device. WMI provider objects use minimal system resources.
For more information about the WdfWmiProviderCreate method, see Supporting WMI in Framework-Based Drivers.
The following code example initializes a WDF_WMI_PROVIDER_CONFIG structure and calls WdfWmiProviderCreate.
WDF_WMI_PROVIDER_CONFIG config; WDFWMIPROVIDER provider; GUID providerGuid = MY_WMI_DATA_BLOCK_GUID; NTSTATUS status; WDF_WMI_PROVIDER_CONFIG_INIT( &config, providerGuid ); config.Flags = WdfWmiProviderTracing; config.EvtWmiProviderFunctionControl = MyProviderFunctionControl; status = WdfWmiProviderCreate( Device, &config, WDF_NO_OBJECT_ATTRIBUTES, &provider );
|Minimum KMDF version||1.0|
|Header||wdfwmi.h (include Wdf.h)|
|Library||Wdf01000.sys (see Framework Library Versioning.)|
|DDI compliance rules||DriverCreate, KmdfIrql, KmdfIrql2|