Функция 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
 Указатель в SListHeadNULL.

Замечания

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

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

Требования

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

См. также

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList

  • Last updated on