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


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

Инициализирует главу единого связанного списка Storport.

Синтаксис

ULONG StorPortInitializeSListHead(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead
);

Параметры

[in] HwDeviceExtension

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

[in, out] SListHead

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

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

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

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

Комментарии

При выделении вызывающим объектом структура STOR_SLIST_HEADER , на которую указывает SListHead , должна быть выровнена по MEMORY_ALLOCATION_ALIGNMENT границе. MEMORY_ALLOCATION_ALIGNMENT определяется в файле miniport.h.

При освобождении памяти для заголовка списка любой код освобождения должен учитывать исходное расположение буфера, содержащего структуру заголовка списка, до корректировки MEMORY_ALLOCATION_ALIGNMENT.

Требования

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

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

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList