다음을 통해 공유

StorPortInvokeAcpiMethod 함수(storport.h)

  • 아티클

StorPortInvokeAcpiMethod 루틴은 스토리지 디바이스에 대한 ACPI 메서드를 실행합니다.

통사론

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
);

매개 변수

[in] HwDeviceExtension

HBA(호스트 버스 어댑터)의 하드웨어 디바이스 확장에 대한 포인터입니다.

[in, optional] Address

대상 디바이스의 주소입니다. 이 매개 변수는 선택 사항입니다. 주소 NULL 설정되면 어댑터가 대상입니다.

[in] MethodName

ACPI 메서드의 4 바이트 이름입니다. 예를 들어 (ULONG) 'DDS_')은 AHCI 컨트롤러의 ACPI 메서드인 _SDD 또는 '디바이스 데이터 설정'의 이름을 지정합니다.

[in, optional] InputBuffer

메서드에 대한 입력 데이터에 대한 포인터입니다.

[in] InputBufferLength

InputBuffer버퍼의 길이(바이트)입니다.

[in, optional] OutputBuffer

메서드의 출력 데이터에 대한 포인터입니다.

[in] OutputBufferLength

OutputBuffer버퍼의 길이(바이트)입니다.

[out, optional] BytesReturned

OutputBuffer반환된 데이터의 길이(바이트)에 대한 포인터입니다.

반환 값

StorPortInvokeAcpiMethod 루틴은 다음 상태 코드 중 하나를 반환합니다.

반환 코드 묘사
STOR_STATUS_INVALID_UNSUCCESSFUL
 일반적인 오류 조건이 있습니다.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension, InputBuffer또는 OutputBuffer NULL입니다.

-또는-

주소 존재하지 않는 대상을 나타냅니다.
STOR_STATUS_NOT_IMPLEMENTED
 ACPI 메서드가 구현되지 않았습니다.
STOR_STATUS_INSUFFICIENT_RESOURCES
 메서드를 실행할 수 있는 리소스가 부족하거나 OutputBufferLength 반환된 데이터에 충분하지 않은.
STOR_STATUS_INVALID_IRQL
 현재 IRQL > PASSIVE_LEVEL.
STOR_STATUS_SUCCESS
 메서드가 성공적으로 실행되었습니다.

발언

StorPortInvokeAcpiMethod 미니포트 드라이버는 스토리지 컨트롤러 및 스토리지 LUN에 대해 정의된 ACPI 메서드를 호출할 수 있습니다. 메서드 이름은 MethodNameULONG 값을 차지하는 4 바이트 문자열입니다.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows 8 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 보편적
헤더 storport.h(Storport.h 포함)
IRQL PASSIVE_LEVEL