StorPortGetNodeAffinity2 - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// storport.h
ULONG StorPortGetNodeAffinity2(
PVOID HwDeviceExtension,
ULONG NodeNumber,
PGROUP_AFFINITY GroupAffinities,
USHORT GroupAffinitiesCount,
PUSHORT GroupAffinitiesCountRequired
);
View the official Windows Driver Kit DDI referenceNo description available.
A miniport can call StorPortGetNodeAffinity2 to get the current multi-group processor affinity of the given NUMA node.
HwDeviceExtension[in] Pointer to the miniport's device extension.
NodeNumber[in] The node number of the node to query.
GroupAffinities[out] Pointer to an array of GROUP_AFFINITY structures that, upon success, receive a group number and the affinity mask of the identified group.
GroupAffinitiesCount[in] The number of elements in the array that GroupAffinities points to. If the array is too small to hold the node affinity then STATUS_BUFFER_TOO_SMALL is returned and the number of elements required is returned in GroupAffinitiesRequired.
GroupAffinitiesCountRequired[out] Pointer to a value that receives the number of group affinities required to represent the node affinity.
StorPortGetNodeAffinity2 returns STOR_STATUS_SUCCESS if the node affinity was queried successfully. Possible error return values include the following.
| Return code | Description |
|---|---|
| STOR_STATUS_INVALID_PARAMETER | There is an invalid parameter, such as an invalid NodeNumber value. |
| STOR_STATUS_BUFFER_TOO_SMALL | The supplied array is too small. |
| STOR_STATUS_UNSUCCESSFUL | An error occurred for internal reasons. |
See the Remarks section of KeQueryNodeActiveAffinity2 for details.