Fungsi StorPortPoFxSetPerfState (storport.h)

StorPortPoFxSetPerfState menetapkan status P komponen (performa atau "perf").

Sintaks

ULONG StorPortPoFxSetPerfState(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         Component,
  ULONG         Flags,
  ULONG         SetIndex,
  ULONG         State,
  PVOID         Context
);

Parameter

HwDeviceExtension

Arahkan ke ekstensi perangkat miniport.

Address

Alamat perangkat yang sedang didaftarkan. Saat ini hanya adaptor yang didukung, jadi Alamat harus NULL.

Component

Indeks yang mengidentifikasi komponen yang status P-nya akan dikelola. Parameter ini adalah indeks ke dalam array Komponendalam struktur STOR_POFX_DEVICE yang digunakan miniport untuk mendaftarkan perangkat untuk dukungan Storport PoFx. Jika array Komponen berisi elemen N, indeks komponen berkisar antara 0 hingga N–1.

Flags

Saat ini harus diatur ke NULL.

SetIndex

Indeks set perf yang terdaftar sebelumnya.

State

Jika set perf berisi P-States diskrit, ini harus menjadi nilai indeks. Jika set perf adalah rentang, ini harus menjadi nilai dalam rentang tersebut.

Context

Konteks arbitrer yang akan diteruskan ke panggilan balik perubahan set perf.

Mengembalikan nilai

StorPortPoFxSetPerfState mengembalikan STOR_STATUS_SUCCESS setelah berhasil diselesaikan atau jika daya runtime telah dinonaktifkan, atau kode kesalahan seperti salah satu hal berikut ini:

Kode kesalahan Makna
STOR_STATUS_INVALID_PARAMETER Salah satu parameter tidak valid; misalnya, Alamat atau Bendera bukan NULL.
STOR_STATUS_UNSUCCESSFUL Adaptor tidak terdaftar untuk deteksi diam.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Header storport.h