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

Статья
02/29/2024

Инициализирует главу единого связанного списка 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

Share via