Fungsi StorPortInitializeSListHead (storport.h)

Artikel
03/05/2024

Menginisialisasi kepala daftar tertaut yang dikelola Storport.

Sintaks

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

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat keras untuk adaptor bus host (HBA).

[in, out] SListHead

Penunjuk ke struktur STOR_SLIST_HEADER yang mewakili kepala daftar yang ditautkan dengan sesuka hati. Struktur ini dianggap buram dan hanya untuk digunakan oleh driver Storport.

Nilai kembali

StorPortInitializeSListHead mengembalikan salah satu kode status berikut:

Menampilkan kode	Deskripsi
STOR_STATUS_NOT_IMPLEMENTED	Fungsi ini tidak diimplementasikan pada sistem operasi aktif.
STOR_STATUS_SUCCESS	Kepala daftar yang diarahkan oleh SListHead berhasil diinisialisasi.
STOR_STATUS_INVALID_PARAMETER	Penunjuk di SListHead adalah NULL.

Keterangan

Saat dialokasikan oleh pemanggil, struktur STOR_SLIST_HEADER yang diarahkan oleh SListHead harus diratakan pada batas MEMORY_ALLOCATION_ALIGNMENT . MEMORY_ALLOCATION_ALIGNMENT didefinisikan dalam miniport.h.

Ketika memori untuk kepala daftar dibebaskan, kode dealokasi apa pun harus mempertanggungjawabkan lokasi asli buffer yang berisi struktur kepala daftar sebelum penyesuaian untuk MEMORY_ALLOCATION_ALIGNMENT.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di mulai dengan Windows 8.
Target Platform	Universal
Header	storport.h (termasuk Storport.h)
IRQL	<= DISPATCH_LEVEL

Lihat juga

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList

Bagikan melalui