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 |