Fungsi StorPortSetPowerSettingNotificationGuids (storport.h)

  • Artikel

Rutinitas StorPortSetPowerSettingNotificationGuids memungkinkan miniport menerima pemberitahuan pengaturan daya. Miniport mendaftarkan array GUID yang mengidentifikasi pengaturan daya untuk menerima pemberitahuan perubahan daya.

Sintaks

ULONG StorPortSetPowerSettingNotificationGuids(
  [in] PVOID  HwDeviceExtension,
  [in] ULONG  GuidCount,
  [in] LPGUID Guid
);

Parameter

[in] HwDeviceExtension

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

[in] GuidCount

Jumlah GUID dalam array Guid .

[in] Guid

Array GUID pengaturan daya untuk mendaftar pemberitahuan. Penggunaan umum untuk mendaftarkan GUID ini adalah agar miniport SATA menerima pemberitahuan untuk perubahan pengaturan AHCI Link Power Management. Pengaturan AHCI Link Power Management yang ditentukan oleh driver miniport Microsoft AHCI StorPort adalah sebagai berikut.

Pengaturan HIPM/DIPM (0b2d69d7-a2a1-449c-9680-f91c70521c60)

Mengonfigurasi mode manajemen daya tautan untuk perangkat disk dan penyimpanan yang melekat pada sistem melalui antarmuka AHCI.

Indeks Nama Deskripsi
0 Aktif Manajemen daya tautan tidak digunakan.
1 HIPM Host-Initiated Power Management (HIPM) digunakan.
2 HIPM dan DIPM HIPM dan Device-Initiated Power Management (DIPM) digunakan.
 

Pengaturan Adaptif (dab60367-53fe-4fbc-825e-521d069d2456)

Periode waktu menganggur tautan AHCI sebelum tautan dimasukkan ke dalam status tidur ketika HIPM atau DIPM diaktifkan.

Nilai Deskripsi
0 Nilai minimum dalam milidetik (hanya gunakan Status parsial).
... Nilai perantara apa pun.
300000 Nilai maksimum dalam milidetik (5 menit).
 

Miniport lain dapat menentukan dan mendaftarkan GUID pengaturan daya mereka sendiri.

Mengembalikan nilai

Rutinitas StorPortSetPowerSettingNotificationGuids mengembalikan salah satu kode status ini:

Menampilkan kode Deskripsi
STOR_STATUS_INSUFFICIENT_RESOURCES
 Sumber daya yang tidak mencukup tersedia untuk mendaftar pemberitahuan.
STOR_STATUS_SUCCESS
 GUID pemberitahuan berhasil didaftarkan.

Keterangan

Miniport memanggil StorPortSetPowerSettingNotificationGuids dalam rutinitas HwStorFindAdapter untuk mendaftarkan GUID yang dimintanya untuk menerima pemberitahuan.

Ketika perubahan status daya terjadi untuk pemberitahuan terdaftar, miniport diberi tahu dalam rutinitas HwStorAdapterControl-nya . Jenis kontrol ScsiPowerSettingNotification diatur dalam parameter ControlType .

Pengaturan manajemen Ahci Link Power adalah bagian dari subgrup Pengaturan Disk (0012ee47-9041-4b5d-9b77-535fba8b1442) dalam konfigurasi kebijakan daya. Ini dikelola di bawah alias konfigurasi SUB_DISK dengan powercfg.exe.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di mulai dengan Windows 8.
Target Platform Universal
Header storport.h (termasuk Storport.h)
IRQL Apa pun

Lihat juga

HwStorAdapterControl

HwStorFindAdapter