Skip to content

Latest commit

 

History

History
87 lines (67 loc) · 2.45 KB

nf-storport-storportgetnodeaffinity2.md

File metadata and controls

87 lines (67 loc) · 2.45 KB
UID tech.root title ms.date targetos description prerelease req.assembly req.construct-type req.ddi-compliance req.dll req.header req.idl req.include-header req.irql req.kmdf-ver req.lib req.max-support req.namespace req.redist req.target-min-winverclnt req.target-min-winversvr req.target-type req.type-library req.umdf-ver req.unicode-ansi topic_type api_type api_location api_name f1_keywords dev_langs helpviewer_keywords
NF:storport.StorPortGetNodeAffinity2
storage
StorPortGetNodeAffinity2
05/24/2022
Windows
Learn more about the StorPortGetNodeAffinity2 function.
false
function
storport.h
Windows 11, version 22H2
apiref
HeaderDef
storport.h
StorPortGetNodeAffinity2
StorPortGetNodeAffinity2
storport/StorPortGetNodeAffinity2
c++
StorPortGetNodeAffinity2

-description

A miniport can call StorPortGetNodeAffinity2 to get the current multi-group processor affinity of the given NUMA node.

-parameters

-param HwDeviceExtension

[in] Pointer to the miniport's device extension.

-param NodeNumber

[in] The node number of the node to query.

-param 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.

-param 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.

-param GroupAffinitiesCountRequired

[out] Pointer to a value that receives the number of group affinities required to represent the node affinity.

-returns

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.

-remarks

See the Remarks section of KeQueryNodeActiveAffinity2 for details.

-see-also

GROUP_AFFINITY