Fungsi StorPortInitializePerfOpts (storport.h)

Artikel
03/01/2024

Fungsi StorPortInitializePerfOpts menginisialisasi pengoptimalan performa yang didukung driver miniport dan driver Storport menggunakan struktur PERF_CONFIGURATION_DATA .

Sintaks

ULONG StorPortInitializePerfOpts(
  [in]      PVOID                    HwDeviceExtension,
  [in]      BOOLEAN                  Query,
  [in, out] PPERF_CONFIGURATION_DATA PerfConfigData
);

Parameter

[in] HwDeviceExtension

Pointer ke ekstensi perangkat keras untuk adaptor bus host (HBA). Parameter ini tidak boleh NULL.

[in] Query

Jika diatur ke TRUE, Storport akan mengatur bendera di PerfConfigData yang sesuai dengan pengoptimalan yang didukung Storport. Jika diatur ke FALSE, Storport akan menginisialisasi pengoptimalan yang ditentukan oleh bendera di PerfConfigData.

[in, out] PerfConfigData

Penunjuk ke struktur PERF_CONFIGURATION_DATA yang disediakan oleh driver miniport. Parameter ini tidak boleh NULL.

Nilai kembali

StorPortInitializePerfOpts mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
STOR_STATUS_NOT_IMPLEMENTED	Fungsi ini tidak diimplementasikan pada sistem operasi aktif.
STOR_STATUS_SUCCESS	Menunjukkan bahwa pengaturan pengoptimalan performa telah diterapkan. Atau jika Kueri diatur ke TRUE, anggota Bendera struktur yang ditujukkan oleh PerfConfigData berisi bendera yang didukung.
STOR_STATUS_UNSUCCESSFUL	Driver miniport menetapkan bendera di PerfConfigData yang tidak dikenali Storport, atau driver miniport telah menyebut rutinitas ini dari luar rutinitas HwStorInitialize yang disediakan pengemudi miniport.
STOR_STATUS_INSUFFICIENT_RESOURCES	Tidak dapat mengalokasikan struktur internal untuk mendukung pengoptimalan yang diminta.
STOR_STATUS_INVALID_PARAMETER	Baik parameter HwDeviceExtension atau parameter PerfConfigData adalah NULL.

Keterangan

Driver miniport dapat memanggil StorPortInitializePerfOpts hanya selama rutinitas HwStorInitialize yang disediakan miniport atau rutinitas HwStorPassiveInitializeRoutine .

Pengoptimalan performa yang tersedia bergantung pada versi PERF_CONFIGURATION_DATA. Mengatur anggota Versi ke STOR_PERF_VERSION akan memungkinkan semua pengoptimalan yang didukung dipilih.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	storport.h (termasuk Storport.h)
Aturan kepatuhan DDI	StorPortPerfOpts(storport)

Lihat juga

PERF_CONFIGURATION_DATA

Bagikan melalui