IWDFDeviceInitialize::SetPowerPolicyOwnership method (wudfddi.h)

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

The SetPowerPolicyOwnership method sets the ownership of the power policy to a driver or removes ownership from the driver.

Syntax

void SetPowerPolicyOwnership(
  [in] BOOL fTrue
);

Parameters

[in] fTrue

A BOOL value that specifies whether to set power-policy ownership to the driver or remove ownership from the driver. TRUE indicates to set power-policy ownership to the driver; FALSE indicates to remove ownership from the driver.

Return value

None

Remarks

By default, UMDF drivers are not registered as power-policy owners for their device stack. To register itself as the power-policy owner for its device stack, a UMDF driver must explicitly call SetPowerPolicyOwnership and pass TRUE to the fTrue parameter in this call.

For more information, see Power Policy Ownership in UMDF.

Examples

For a code example of how to use the SetPowerPolicyOwnership method, see IWDFDriver::CreateDevice.

Requirements

Requirement Value
End of support Unavailable in UMDF 2.0 and later.
Target Platform Desktop
Minimum UMDF version 1.5
Header wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

See also

IWDFDeviceInitialize

IWDFDriver::CreateDevice