WdfDeviceInitSetPowerPolicyOwnership 函式 (wdfdevice.h)

[適用於 KMDF 和 UMDF]

WdfDeviceInitSetPowerPolicyOwnership 方法會建立呼叫驅動程式是否為指定裝置的電源原則擁有者。

語法

void WdfDeviceInitSetPowerPolicyOwnership(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] BOOLEAN         IsPowerPolicyOwner
);

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的呼叫 端提供的指標。

[in] IsPowerPolicyOwner

布爾值,指出呼叫驅動程式是否為電源原則擁有者。 如果 為 TRUE,則呼叫驅動程式是電源原則擁有者。 如果 為 FALSE,則不是電源原則擁有者。

傳回值

備註

如果您要撰寫架構型函式驅動程式,架構會自動將您的驅動程式建立為電源原則擁有者。 (如果裝置以原始模式運作,總線驅動程式是預設電源原則擁有者。)

若要變更默認電源原則擁有者,下列兩個驅動程序必須呼叫 WdfDeviceInitSetPowerPolicyOwnership

  • 默認電源原則擁有者必須呼叫 WdfDeviceInitSetPowerPolicyOwnership並將 IsPowerPolicyOwner 設定為 FALSE
  • 您想要成為電源原則擁有者的驅動程序必須呼叫 WdfDeviceInitSetPowerPolicyOwnership並將 IsPowerPolicyOwner 設定為 TRUE
如果您要撰寫架構型總線驅動程式或篩選驅動程式,如果裝置未以原始模式運作,則除非驅動程式呼叫 WdfDeviceInitSetPowerPolicyOwnership,否則您的驅動程式將不會是電源原則擁有者。

每個堆疊中只有一個驅動程式可以是電源原則擁有者,因此您必須確定只有一個驅動程式呼叫 WdfDeviceInitSetPowerPolicyOwnership並將 IsPowerPolicyOwner 設定為 TRUE

如果您的驅動程式呼叫 WdfDeviceInitSetPowerPolicyOwnership,則必須先這麼做,才能呼叫 WdfDeviceCreate。 如需詳細資訊,請參閱 建立 Framework 裝置物件

如需呼叫 WdfDeviceInitSetPowerPolicyOwnership 的詳細資訊,請參閱 Power Policy 擁有權

範例

下列程式代碼範例來自 序列 範例驅動程式。 本範例會檢查登錄值,以判斷驅動程式是否應該是電源原則擁有者。 如果驅動程式不應該是電源原則擁有者,此範例會呼叫 WdfDeviceInitSetPowerPolicyOwnership

//
// Call subroutine that checks a registry value.
//
SerialGetFdoRegistryKeyValue(
                             DeviceInit,
                             L"SerialRelinquishPowerPolicy",
                             &relinquishPowerPolicy
                             );
//
// If the registry value is TRUE, do not own power policy.
//
if(relinquishPowerPolicy) {
    WdfDeviceInitSetPowerPolicyOwnership(
                                         DeviceInit,
                                         FALSE
                                         );
}

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfdevice.h (包含 Wdf.h)
程式庫 Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 ChildDeviceInitAPI (kmdf) DeviceInitAPI (kmdf ) 、 DriverCreate (kmdf) FDOPowerPolicyOwnerAPI (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf) 、 PdoDeviceInitAPI (kmdf)

另請參閱

WdfDeviceCreate