Функция StorPortInterlockedFlushSList (storport.h)

Статья
02/07/2025

Удаляет все элементы из управляемого списка, управляемого Storport. Доступ к списку синхронизирован в многопроцессорной системе

Синтаксис

ULONG StorPortInterlockedFlushSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSTOR_SLIST_ENTRY  *Result
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[in, out] SListHead

Указатель на структуру STOR_SLIST_HEADER, представляющую голову последовательно связанного списка. Эта структура считается непрозрачной и используется только драйвером Storport.

[out] Result

Указатель на указатель на указатель записи списка. Возвращаемое значение — это указатель на элементы, удаленные из списка. Если список пуст, NULL возвращается в значении, на которое указывает результирующий.

Возвращаемое значение

StorPortInterlockedFlushSList возвращает один из следующих кодов состояния:

Возвращаемый код	Описание
STOR_STATUS_NOT_IMPLEMENTED	Эта функция не реализована в активной операционной системе.
STOR_STATUS_SUCCESS	Элементы списка были удалены успешно или список уже пуст.
STOR_STATUS_INVALID_PARAMETER	Указатель на SListHead или результатом является NULL.

Замечания

StorPortInterlockedFlushSList также возвращает STATUS_SUCCESS, если записи не находятся в списке. Значение указателя, на которое ссылается Результирующий, необходимо оценить для NULL, чтобы убедиться, что не были возвращены записи.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8.
целевая платформа	Всеобщий
заголовка	storport.h (include Storport.h)
IRQL	<= DISPATCH_LEVEL

См. также

StorPortInitializeSListHead

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList

Поделиться через