StorPortRevertToUserGroupAffinityThread function (storport.h)

Article
02/22/2024

Syntax

ULONG StorPortRevertToUserGroupAffinityThread(
  [in]          PVOID                HwDeviceExtension,
  [in/optional] PVOID                ThreadContext,
  [in]          PSTOR_GROUP_AFFINITY PreviousAffinity
);

Parameters

[in] HwDeviceExtension

Pointer to the miniport's hardware device extension.

[in/optional] ThreadContext

Pointer to the thread context received in a prior call to StorPortCreateSystemThread.

[in] PreviousAffinity

Pointer to a STOR_GROUP_AFFINITY structure with the group affinity to restore. This group affinity was obtained in a prior call to StorPortSetSystemGroupAffinityThread.

Return value

StorPortRevertToUserGroupAffinityThread returns one of the following values:

Return code	Description
STOR_STATUS_SUCCESS	The original group affinity was restored successfully.
STOR_STATUS_INVALID_IRQL	IRQL level must be <= DISPATCH_LEVEL.
STOR_STATUS_INVALID_PARAMETER	One or more of the provided parameters are invalid.
STOR_STATUS_UNSUCCESSFUL	Returned for other internal system reasons.

Remarks

If a miniport calls StorPortSetSystemGroupAffinityThread to temporarily change the group affinity of the thread, then it should call StorPortRevertToUserGroupAffinityThread to revert thread affinity to its original value before the thread exits.

Requirements

Requirement	Value
Minimum supported server	Windows Server 2022
Header	storport.h