ISensorClassExtension::Initialize method (sensorsclassextension.h)

The ISensorClassExtension::Initialize method initializes the sensor class extension object.

Syntax

HRESULT Initialize(
  IUnknown *pWdfDeviceUnknown,
  IUnknown *pSensorDriverUnknown
);

Parameters

pWdfDeviceUnknown

IUnknown pointer for the driver class that implements the IWDFDevice interface.

pSensorDriverUnknown

IUnknown pointer for the object that implements the ISensorDriver callback interface.

Return value

This method returns an HRESULT. Possible values include, but are not limited to, one of the following values. See Remarks.

Remarks

First, create the sensor class extension by calling the COM CoCreateInstance method, and then call Initialize. We recommend that you perform these initialization steps when called by UMDF in IPnpCallbackHardware::OnPrepareHardware. After Initialize returns, the driver must be ready to receive callbacks from the sensor class extension. The sensor class extension calls ISensorDriver::OnGetSupportedSensorObjects during initialization. Your driver must be ready to return values for all required properties and data fields before it calls Initialize.

Because the class extension calls your driver during initialization, this method can also return HRESULTs that your driver returns from ISensorDriver::OnGetSupportedSensorObjects.

Requirements

See also

ISensorClassExtension