共用方式為


ISensorClassExtension::Initialize 方法 (sensorsclassextension.h)

ISensorClassExtension::Initialize 方法會初始化感測器類別擴充物件。

語法

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

參數

pWdfDeviceUnknown

實作 IWDFDevice 介面之驅動程式類別的 IUnknown 指標。

pSensorDriverUnknown

實作 ISensorDriver 回呼介面之物件的 IUnknown 指標。

傳回值

這個方法會傳回 HRESULT。 可能的值包括下列其中一個值,但不限於下列其中一個值。 請參閱<備註>。

傳回碼 描述
S_OK 此方法已成功。
E_POINTER 自變數為 NULL 或遺漏 IWDFDevice 介面。
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS) 類別延伸模組已經初始化。
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED) 類別延伸模組已經初始化。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) 感測器的WPD_OBJECT_ID無效。

備註

首先,呼叫 COM CoCreateInstance 方法來建立感測器類別延伸模組,然後呼叫 Initialize。 建議您在 IPnpCallbackHardware::OnPrepareHardware 中由 UMDF 呼叫時執行這些初始化步驟。 初始化傳回之後,驅動程式必須準備好從感測器類別延伸模組接收回呼。 感測器類別延伸模組會在初始化期間呼叫 ISensorDriver::OnGetSupportedSensorObjects 。 您的驅動程序必須先準備好傳回所有必要屬性和數據欄位的值,才能呼叫 Initialize。

因為類別延伸模組會在初始化期間呼叫您的驅動程式,所以此方法也可以傳回驅動程式從 ISensorDriver::OnGetSupportedSensorObjects 傳回的 HRESULT。

規格需求

需求
目標平台 Windows
標頭 sensorsclassextension.h
程式庫 SensorsClassExtension.lib

另請參閱

ISensorClassExtension