Fungsi StorPortInitialize (storport.h)

  • Artikel

Rutinitas StorPortInitialize menginisialisasi parameter driver port dan data ekstensi. StorPortInitialize juga menyimpan informasi adaptor yang disediakan dari rutinitas driver miniportDriverEntry .

Sintaks

STORPORT_API ULONG StorPortInitialize(
  [in]           PVOID                   Argument1,
  [in]           PVOID                   Argument2,
  [in]           _HW_INITIALIZATION_DATA *HwInitializationData,
  [in, optional] PVOID                   HwContext
);

Parameter

[in] Argument1

Pointer pertama yang digunakan oleh sistem operasi yang disebut rutinitas DriverEntry miniport.

[in] Argument2

Penunjuk kedua dengan sistem operasi yang disebut rutinitas DriverEntry miniports.

[in] HwInitializationData

Arahkan ke informasi inisialisasi dan konfigurasi yang ditetapkan oleh driver miniport dalam rutinitas DriverEntry-nya.

[in, optional] HwContext

Adalah alamat nilai konteks yang akan diteruskan ke rutinitas HwStorFindAdapter driver miniport. Hanya driver miniport warisan yang memindai bus untuk HBA daripada menerima informasi konfigurasi dari driver port yang dapat menggunakan parameter ini untuk menyimpan status antara panggilan ke HwStorFindAdapter.

Nilai kembali

Hasil dari tindakan inisialisasi yang dilakukan oleh StorPortInitialize. Driver miniport akan mengembalikan nilai ini sebagai nilai pengembalian untuk rutinitas DriverEntry-nya.

StorPortInitialize mengembalikan salah satu kode status berikut:

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER Argumen1 adalah NULL, atau Argumen2 null, ATAU HwInitializationData adalah NULL.
STATUS_SUCCESS Data ekstensi driver dan informasi adaptor berhasil diinisialisasi.
STATUS_NO_MEMORY Tidak ada memori yang tersedia untuk menyimpan parameter inisialisasi.
STATUS_REVISION_MISMATCH Versi struktur yang diarahkan oleh HwInitializationData tidak valid untuk sistem operasi saat ini.
STATUS_INSUFFICENT_RESOURCES Alokasi gagal untuk data ekstensi objek driver.

Keterangan

Rutinitas ini harus dipanggil dari rutinitas DriverEntry pengemudi miniport.

Karena driver miniport Storport harus mendukung PnP, driver Storport tidak menggunakan parameter HwContext yang diteruskan ke StorPortInitialize.

Setiap rutinitas DriverEntry driver miniport harus memanggil StorPortInitialize setelah driver miniport pertama kali nol dan kemudian mengatur anggota HW_INITIALIZATION_DATA.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header storport.h (termasuk Storport.h)
Pustaka Storport.lib

Lihat juga

HW_INITIALIZATION_DATA

HwStorFindAdapter