RegisterOpRegionHandler 함수(oprghdlr.h)

RegisterOpRegionHandler 루틴은 ACPI 드라이버에 작업 지역 처리기를 등록합니다.

구문

NTSTATUS RegisterOpRegionHandler(
  [in]  PDEVICE_OBJECT          DeviceObject,
  [in]  ULONG                   AccessType,
  [in]  ULONG                   RegionSpace,
  [in]  PACPI_OP_REGION_HANDLER Handler,
  [in]  PVOID                   Context,
  [in]  ULONG                   Flags,
  [out] PVOID                   *OperationRegionObject
);

매개 변수

[in] DeviceObject

작업 영역을 정의하는 ACPI 디바이스를 나타내는 PDO(물리적 디바이스 개체) 에 대한 포인터입니다.

[in] AccessType

ACPI_OPREGION_ACCESS_AS_COOKED 지정합니다.

[in] RegionSpace

다음 유형의 영역 공간 중 하나를 지정합니다.

지역 공간 식별자	Description
ACPI_OPREGION_REGION_SPACE_MEMORY	시스템 메모리
ACPI_OPREGION_REGION_SPACE_IO	I/O 공간
ACPI_OPREGION_REGION_SPACE_PCI_CONFIG	PCI 구성
ACPI_OPREGION_REGION_SPACE_EC	임베디드 컨트롤러
ACPI_OPREGION_REGION_SPACE_SMB	시스템 관리 버스
ACPI_OPREGION_REGION_SPACE_CMOS_CONFIG	CMOS 구성
ACPI_OPREGION_REGION_SPACE_PCIBARTARGET	PCI 기본 주소 레지스터
0x80 0xFF 공급업체 정의 값	공급업체 정의

[in] Handler

ACPI_OP_REGION_HANDLER 형식의 작업 영역 처리기(ACPI 디바이스 함수 드라이버에서 제공)에 대한 포인터입니다.

[in] Context

디바이스별 작업 영역 컨텍스트에 대한 포인터입니다(ACPI 디바이스 함수 드라이버에서 제공).

[in] Flags

내부용으로 예약된 속성입니다.

[out] OperationRegionObject

출력에서 ACPI 드라이버가 작업 영역에 대해 만드는 작업 영역 개체에 대한 포인터를 포함하는 호출자 할당 버퍼에 대한 포인터입니다.

반환 값

다음 상태 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	운영 지역 처리기가 성공적으로 등록되었습니다.
STATUS_ACPI_INVALID_DATA	지정한 정보가 잘못되었습니다.
STATUS_INSUFFICIENT_RESOURCES	루틴에서 필요한 시스템 리소스를 할당할 수 없습니다.
STATUS_Xxx	내부 오류가 발생했습니다.

설명

Context에 지정된 작업 영역 컨텍스트는 디바이스별로 지정되며 함수 드라이버에서만 사용됩니다. 일반적으로 컨텍스트는 FDO(기능 디바이스 개체)에 대한 디바이스 확장입니다. ACPI 드라이버는 작업 영역 처리기를 호출할 때 이 컨텍스트를 함수 드라이버에 다시 전달합니다. 작업 영역 개체는 작업 영역 처리기를 등록 취소할 때 함수 드라이버에서 작업 영역을 고유하게 식별하는 데만 사용됩니다.

작업 지역에 대한 자세한 내용은 작업 지역 지원을 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	oprghdlr.h(Oprghdlr.h 포함)
라이브러리	Oprghdlr.lib
IRQL	PASSIVE_LEVEL

추가 정보

ACPI_OP_REGION_HANDLER

DeRegisterOpRegionHandler