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

대상 디바이스의 주소입니다. 이 매개 변수는 선택적 요소입니다. 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 메서드를 호출할 수 있습니다. 메서드 이름은 MethodName에서 ULONG 값을 차지하는 4 바이트 문자열입니다.

요구 사항

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