Fungsi StorPortInvokeAcpiMethod (storport.h)

Artikel
02/27/2024

Rutinitas StorPortInvokeAcpiMethod menjalankan metode ACPI untuk perangkat penyimpanan.

Sintaks

ULONG StorPortInvokeAcpiMethod(
  [in]            PVOID         HwDeviceExtension,
  [in, optional]  PSTOR_ADDRESS Address,
  [in]            ULONG         MethodName,
  [in, optional]  PVOID         InputBuffer,
  [in]            ULONG         InputBufferLength,
  [in, optional]  PVOID         OutputBuffer,
  [in]            ULONG         OutputBufferLength,
  [out, optional] PULONG        BytesReturned
);

Parameter

[in] HwDeviceExtension

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

[in, optional] Address

Alamat perangkat target. Parameter ini bersifat opsional. Jika Alamat diatur ke NULL, adaptor adalah targetnya.

[in] MethodName

Nama empat byte untuk metode ACPI. Misalnya, ((ULONG) 'DDS_') akan memberi nama _SDD, atau 'Atur Data Perangkat', metode ACPI untuk pengontrol AHCI.

[in, optional] InputBuffer

Penunjuk ke data input ke metode .

[in] InputBufferLength

Panjangnya, dalam byte, dari buffer di InputBuffer.

[in, optional] OutputBuffer

Penunjuk ke data output dari metode .

[in] OutputBufferLength

Panjangnya, dalam byte, dari buffer di OutputBuffer.

[out, optional] BytesReturned

Penunjuk ke panjang, dalam byte, dari data yang dikembalikan di OutputBuffer.

Mengembalikan nilai

Rutinitas StorPortInvokeAcpiMethod mengembalikan salah satu kode status ini:

Menampilkan kode	Deskripsi
STOR_STATUS_INVALID_UNSUCCESSFUL	Ada kondisi kesalahan umum.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, InputBuffer, atau OutputBuffer adalah NULL. -atau- Alamat mengacu pada target yang tidak ada.
STOR_STATUS_NOT_IMPLEMENTED	Metode ACPI tidak diimplementasikan.
STOR_STATUS_INSUFFICIENT_RESOURCES	Sumber daya yang tidak mencukupi tersedia untuk menjalankan metode, atau OutputBufferLength tidak cukup besar untuk data yang dikembalikan.
STOR_STATUS_INVALID_IRQL	> PASSIVE_LEVEL IRQL saat ini.
STOR_STATUS_SUCCESS	Metode berhasil dijalankan.

Keterangan

StorPortInvokeAcpiMethod memungkinkan driver miniport untuk memanggil metode ACPI yang ditentukan untuk pengontrol penyimpanan dan LUN penyimpanan. Nama metode adalah string karakter empat byte yang menempati nilai ULONG di MethodName.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows versi Windows 8 dan yang lebih baru.
Target Platform	Universal
Header	storport.h (termasuk Storport.h)
IRQL	PASSIVE_LEVEL