Fungsi StorPortGetSystemAddress (storport.h)

Artikel
02/29/2024

Rutinitas StorPortGetSystemAddress mengembalikan alamat virtual di ruang sistem untuk buffer data blok permintaan SCSI (SRB) yang ditentukan.

Sintaks

ULONG StorPortGetSystemAddress(
  [in]  PVOID               HwDeviceExtension,
  [in]  PSCSI_REQUEST_BLOCK Srb,
  [out] PVOID               *SystemAddress
);

Parameter

[in] HwDeviceExtension

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

[in] Srb

Penunjuk ke struktur SCSI_REQUEST_BLOCK .

[out] SystemAddress

Penunjuk untuk menerima alamat virtual buffer data.

Nilai kembali

StorPortGetSystemAddress 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 alamat sistem berhasil diperoleh.
STOR_STATUS_INVALID_PARAMETER	Kode status ini disebabkan oleh salah satu kondisi berikut: SRB tidak memiliki buffer data terkait. Penunjuk untuk menerima alamat virtual adalah NULL.
STOR_STATUS_INVALID_IRQL	Panggilan dilakukan pada IRQL yang tidak valid.
STOR_STATUS_INSUFFICIENT_RESOURCES	Upaya untuk memetakan buffer data ke ruang sistem gagal.

Keterangan

Mulai dari Windows 8, parameter Srb dapat menunjuk ke SCSI_REQUEST_BLOCK atau STORAGE_REQUEST_BLOCK. Jika pengidentifikasi fungsi di bidang FungsiSrbSRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB adalah struktur permintaan STORAGE_REQUEST_BLOCK .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rutinitas ini tersedia dimulai dengan Windows Server 2003 dengan SP2.
Target Platform	Universal
Header	storport.h (termasuk Storport.h)
IRQL	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	StorPortIrql(storport)

Lihat juga

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

Share via