Fungsi StorPortPoFxPowerControl (storport.h)

Artikel
08/07/2023

Rutinitas StorPortPoFxPowerControl mengirimkan permintaan kontrol daya ke kerangka kerja manajemen daya (PoFx) untuk meneruskan ke plug-in mesin daya (PEP).

Sintaks

ULONG StorPortPoFxPowerControl(
  [in]            PVOID         HwDeviceExtension,
                  PSTOR_ADDRESS Address,
  [in]            LPCGUID       PowerControlCode,
  [in, optional]  PVOID         InBuffer,
  [in]            SIZE_T        InBufferSize,
  [out, optional] PVOID         OutBuffer,
  [in]            SIZE_T        OutBufferSize,
  [out, optional] PSIZE_T       BytesReturned
);

Parameter

[in] HwDeviceExtension

Pointer ke ekstensi perangkat keras untuk adaptor bus host (HBA). Ini adalah ekstensi perangkat yang digunakan untuk mendaftarkan perangkat dalam panggilan sebelumnya ke StorPortInitializePoFxPower.

Address

Penunjuk ke kode kontrol daya. Kode ini adalah nilai GUID yang menentukan operasi yang diminta.

[in] PowerControlCode

Penunjuk ke kode kontrol daya. Kode ini adalah nilai GUID yang menentukan operasi yang diminta.

[in, optional] InBuffer

Penunjuk ke buffer yang dialokasikan pemanggil yang berisi data input untuk operasi. Format untuk data dalam buffer ini bergantung pada kode kontrol daya yang ditentukan oleh parameter PowerControlCode . Parameter InBuffer bersifat opsional dan dapat ditentukan sebagai NULL jika operasi yang ditentukan tidak memerlukan data input.

[in] InBufferSize

Ukuran, dalam byte, dari buffer input yang diacu oleh parameter InBuffer . Jika InBuffer NULL, atur InBufferSize ke nol.

[out, optional] OutBuffer

Penunjuk ke buffer yang dialokasikan pemanggil yang berisi data output dari operasi. Format untuk data dalam buffer ini bergantung pada kode kontrol daya yang ditentukan oleh parameter PowerControlCode . Parameter OutBuffer bersifat opsional dan dapat ditentukan sebagai NULL jika operasi yang ditentukan tidak menghasilkan data output.

[in] OutBufferSize

Ukuran, dalam byte, dari buffer output yang diacu oleh parameter OutBuffer . Jika OutBuffer NULL, atur OutBufferSize ke nol.

[out, optional] BytesReturned

Penunjuk ke lokasi tempat rutin menulis jumlah byte data yang ditulis ke buffer yang ditujukkan oleh OutBuffer. Jumlah byte yang ditulis akan kurang dari atau sama dengan OutBufferSize. Parameter ini bersifat opsional dan dapat ditentukan sebagai NULL jika pemanggil tidak perlu mengetahui berapa banyak byte yang ditulis ke buffer output.

Nilai kembali

Rutinitas StorPortPoFxPowerControl mengembalikan salah satu kode status ini:

Menampilkan kode	Deskripsi
STOR_STATUS_SUCCESS	Operasi kontrol daya yang ditentukan dalam PowerControlCode berhasil dijalankan.
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.
STOR_STATUS_INVALID_DEVICE_REQUEST	Perangkat penyimpanan tidak terdaftar di PoFx.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL saat ini.
STOR_STATUS_UNSUCCESSFUL	Operasi kontrol daya tidak berhasil.

Keterangan

Driver minport memanggil rutinitas ini untuk mengirim permintaan kontrol daya langsung ke PEP. Permintaan kontrol daya mirip dengan permintaan kontrol I/O (IOCTL). Namun, tidak seperti IOCTL, permintaan kontrol daya dikirim langsung ke PEP dan tidak diamati oleh driver perangkat lain di tumpukan perangkat. Selama panggilan StorPortPoFxPowerControl , PEP secara sinkron melakukan operasi yang diminta.

Demikian pula, PEP dapat mengirim permintaan kontrol daya langsung ke miniport. Driver miniport menangani permintaan ini dalam rutinitas HwStorAdapterControl dan HwStorUnitControl . Parameter ControlType menerima jenis ScsiAdapterPoFxPowerControl dalam rutinitas HwStorAdapterControl dan ScsiUnitPoFxPowerControl dalam rutinitas HwStorUnitControl .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di mulai dengan Windows 8.
Target Platform	Universal
Header	storport.h
Pustaka	Storport.lib
IRQL	<= DISPATCH_LEVEL

Lihat juga

HwStorAdapterControl

HwStorUnitControl

Bagikan melalui