Fungsi StorPortAllocateMdl (storport.h)

  • Artikel

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)