Edit

Share via

StorPortGetGroupAffinity function (storport.h)

  • Article

The StorPortGetGroupAffinity routine constructs a mask of the active processors in a requested group.

Syntax

ULONG StorPortGetGroupAffinity(
  [in]  PVOID      HwDeviceExtension,
  [in]  USHORT     GroupNumber,
  [out] PKAFFINITY GroupAffinityMask
);

Parameters

[in] HwDeviceExtension

A pointer to the hardware device extension for the host bus adapter (HBA).

[in] GroupNumber

The group from which to return the processor mask.

[out] GroupAffinityMask

A pointer to a variable that holds the affinity mask of the given group.

Return value

The StorPortGetGroupAffinity routine returns one of the following status codes:

Return code Description
STOR_STATUS_NOT_IMPLEMENTED
 This function is not implemented on the active operating system.
STOR_STATUS_SUCCESS
 The operation was successful.
STOR_STATUS_INVALID_PARAMETER
 The operation fails with this return value if one or more of the parameters are invalid, for example, if GroupAffinityMask is set to NULL.
STOR_STATUS_UNSUCCESSFUL
 The operation fails with this return value if one or more of the parameters are invalid, for example, if GroupNumber is set to a value greater than the active group count.

Requirements

Requirement Value
Minimum supported client Available in Windows 7 and later versions of the Windows operating systems.
Target Platform Universal
Header storport.h (include Storport.h)
IRQL <=DISPATCH_LEVEL
DDI compliance rules StorPortIrql(storport)