Fungsi StorPortAllocateMdl (storport.h)

Artikel
03/01/2024

Rutinitas StorPortAllocateMdl mengalokasikan MDL untuk menjelaskan memori kumpulan non-halaman yang diberikan.

Sintaks

ULONG StorPortAllocateMdl(
  [in]  PVOID HwDeviceExtension,
  [in]  PVOID BufferPointer,
  [in]  ULONG NumberOfBytes,
  [out] PVOID *Mdl
);

Parameter

[in] HwDeviceExtension

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

[in] BufferPointer

Penunjuk ke alamat virtual dasar buffer yang akan dijelaskan MDL.

[in] NumberOfBytes

Parameter ini menentukan panjang, dalam byte, dari buffer yang akan dijelaskan MDL.

[out] Mdl

Penunjuk untuk menerima MDL yang dialokasikan.

Nilai kembali

StorPortAllocateMdl mengembalikan salah satu kode status berikut:

Menampilkan kode	Deskripsi
STOR_STATUS_NOT_IMPLEMENTED	Fungsi ini tidak diimplementasikan pada sistem operasi aktif.
STOR_STATUS_SUCCESS	Menunjukkan bahwa rutinitas berhasil mengalokasikan MDL.
STOR_STATUS_INVALID_PARAMETER	Penunjuk untuk menerima MDL adalah NULL. Penunjuk ke buffer adalah NULL.
STOR_STATUS_INVALID_IRQL	Panggilan dilakukan pada IRQL yang tidak valid.
STOR_STATUS_INSUFFICIENT_RESOURCES	Tidak dapat mengalokasikan MDL untuk menjelaskan buffer yang diberikan.

Keterangan

Driver miniport memanggil rutinitas StorPortAllocateMdl untuk mengalokasikan MDL untuk menjelaskan blok memori dari kumpulan non-halaman. Untuk membebaskan MDL, driver miniport memanggil rutinitas StorPortFreeMdl .

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	storport.h (termasuk Storport.h)
IRQL	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	StorPortIrql(storport)

Bagikan melalui