StorPortPoFxActivateComponent function (storport.h)
The StorPortPoFxActivateComponent routine increments the activation reference count on the specified component of a storage device.
ULONG StorPortPoFxActivateComponent(
[in] PVOID HwDeviceExtension,
[in, optional] PSTOR_ADDRESS Address,
[in, optional] PSCSI_REQUEST_BLOCK Srb,
[in] ULONG Component,
[in] ULONG Flags
);
[in] HwDeviceExtension
A pointer to the hardware device extension for the host bus adapter (HBA).
[in, optional] Address
The address of a storage device unit. This parameter is NULL when activating a storage adapter component.
[in, optional] Srb
The SRB triggering the component activation. This parameter is NULL if the miniport is activating a device component for a request not sent through Storport.
[in] Component
The index that identifies the component. This parameter is an index into the Components array in the STOR_POFX_DEVICE structure that the miniport driver registered for the device with a call to StorPortInitializePoFxPower. If the Components array contains N elements, component indexes range from 0 to N–1.
[in] Flags
Not used. Set to 0.
The StorPortPoFxActivateComponent routine returns one of these status codes:
| Return code | Description |
|---|---|
|
The storage device activation reference was successfully incremented and the component is in the active state. |
|
Either HwDeviceExtension or Device is NULL.
-or- Address points to an invalid unit address structure. -or- The storage device specified by Address is not found. -or- The storage device is not registered with the power management framework (PoFx). -or- The SRB pointed to by Srb is not sent from Storport. -or- The Flags parameter is nonzero. |
|
The adapter or unit does not support PoFx. |
|
The current IRQL > DISPATCH_LEVEL. |
|
The storage device activation reference was successfully incremented but the component is still in the idle state |
Currently, both adapter devices and unit devices have maximum component count of 1. The index in Component must always be set to 0.
Each call to StorPortPoFxActivateComponent must be matched with a subsequent call to StorPortPoFxIdleComponent.
| Requirement | Value |
|---|---|
| Minimum supported client | Available in starting with Windows 8. |
| Target Platform | Universal |
| Header | storport.h |
| Library | Storport.lib |
| IRQL | IRQL <= DISPATCH_LEVEL |