IWDFDeviceInitialize 介面 (wudfddi.h)
[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1,且較新版本的 #D8E67123E09DF4099822347F3133FEA22 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]
IWDFDeviceInitialize 介面是協助程式介面,架構會提供作為驅動程式 IDriverEntry::OnDeviceAdd 方法的輸入參數。
繼承
IWDFDeviceInitialize 介面繼承自 IUnknown 介面。 IWDFDeviceInitialize 也有下列類型的成員:
- 方法
方法
IWDFDeviceInitialize 介面具有這些方法。
IWDFDeviceInitialize::AutoForwardCreateCleanupClose AutoForwardCreateCleanupClose 方法可控制建立、清除和關閉通知何時會轉送到裝置堆棧中的下一個較低驅動程式。 |
IWDFDeviceInitialize::GetPnpCapability GetPnpCapability 方法會決定指定之 隨插即用 (PnP) 功能的狀態。 |
IWDFDeviceInitialize::RetrieveDeviceInstanceId 本文說明 RetrieveDeviceInstanceId 方法如何擷取裝置實例的標識碼。 |
IWDFDeviceInitialize::RetrieveDevicePropertyStore RetrieveDevicePropertyStore 方法會擷取用戶端可透過讀取和寫入裝置屬性的裝置屬性存放區。 |
IWDFDeviceInitialize::SetFilter SetFilter 方法會設定屬性,讓裝置成為篩選裝置。 |
IWDFDeviceInitialize::SetLockingConstraint SetLockingConstraint 方法會將回呼函式的同步處理 (或鎖定) 模型設定為驅動程式。 |
IWDFDeviceInitialize::SetPnpCapability SetPnpCapability 方法會將裝置的指定 隨插即用 (PnP) 功能設定為指定的狀態。 |
IWDFDeviceInitialize::SetPowerPolicyOwnership SetPowerPolicyOwnership 方法會將電源原則的擁有權設定為驅動程式,或從驅動程式移除擁有權。 |
備註
驅動程式會呼叫這個介面的方法,以設定新裝置對象的屬性,並將此介面當做 IWDFDriver::CreateDevice 方法的輸入傳遞至 IWDFDriver::CreateDevice 方法,以建立新的裝置物件。
呼叫 IWDFDriver::CreateDevice 之後,請勿使用此介面。
規格需求
需求 | 值 |
---|---|
終止支援 | UMDF 2.0 和更新版本中無法使用。 |
目標平台 | 桌面 |
最低UMDF版本 | 1.5 |
標頭 | wudfddi.h (包括 Wudfddi.h) |