Fungsi StorPortInitializePerfOpts (storport.h)

  • Artikel

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