Fungsi StorPortInitializePoFxPower (storport.h)

  • Artikel

Driver miniport memanggil StorPortInitializePoFxPower untuk mendaftarkan perangkat penyimpanan dengan kerangka kerja manajemen daya (PoFx).

Sintaks

ULONG StorPortInitializePoFxPower(
  [in]           PVOID             HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS     Address,
  [in]           PSTOR_POFX_DEVICE Device,
  [in, out]      PBOOLEAN          D3ColdEnabled
);

Parameter

[in] HwDeviceExtension

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

[in, optional] Address

Alamat unit perangkat penyimpanan. Parameter ini NULL saat mendaftar untuk adaptor penyimpanan.

[in] Device

Penunjuk ke struktur STOR_POFX_DEVICE_V2 dilemparkan ke penunjuk ke STOR_POFX_DEVICE. Struktur ini berisi daftar komponen dengan status F untuk perangkat penyimpanan.

[in, out] D3ColdEnabled

Penunjuk ke nilai BOOLEAN yang akan diatur driver Storport untuk menunjukkan apakah status Dingin D3 diaktifkan untuk perangkat penyimpanan.

Nilai kembali

Rutinitas StorPortInitializePoFxPower mengembalikan salah satu kode status ini:

Menampilkan kode Deskripsi
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension atau Device adalah NULL.

-atau-

Alamat menunjuk ke struktur alamat unit yang tidak valid.

-atau-

Perangkat penyimpanan yang ditentukan oleh Alamat tidak ditemukan.

-atau-

Struktur STOR_POFX_DEVICE yang ditunjukkan oleh Perangkat diformat dengan salah atau berisi data yang tidak valid.
STOR_STATUS_SUCCESS
 Perangkat penyimpanan berhasil didaftarkan dengan PoFx.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Sumber daya yang memadai tidak tersedia untuk mendaftarkan perangkat penyimpanan dengan PoFx.
STOR_STATUS_UNSUCCESSFUL
 Perangkat penyimpanan tidak berhasil didaftarkan dengan PoFx.

-atau-

Perangkat penyimpanan sudah terdaftar di PoFx.

Keterangan

Perangkat adaptor selalu terdaftar dengan nilai NULL untuk alamat. Perangkat unit didaftarkan dengan menentukan alamat unit yang valid untuk alamat.

Jika bendera STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD diatur di anggota BenderaPerangkat, Storport akan mencoba mengaktifkan dukungan D3 Cold untuk komponen perangkat. Status D3 Cold diaktifkan dikembalikan dalam nilai BOOLEAN yang ditunjukkan oleh D3ColdEnabled.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di mulai dengan Windows 8.
Target Platform Universal
Header storport.h

Lihat juga

STOR_POFX_DEVICE