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)