共用方式為

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