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

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

  • Статья

Извлекает количество записей в отдельном списке, управляемом Storport.

Синтаксис

ULONG StorPortQueryDepthSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSHORT             Result
);

Параметры

[in] HwDeviceExtension

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

[in, out] SListHead

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

[out] Result

Указатель на значение SHORT , которое получает количество глубины списка.

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

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

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

Комментарии

Так как StorPortQueryDepthSList не блокируется, значение глубины списка, указываемое результатом при возврате, не является надежным в случае, если в списке работает несколько потоков.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 8.
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)
IRQL <= DISPATCH_LEVEL

См. также раздел

StorPortInitializesListHead

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList