DXGKDDI_NOTIFY_ACPI_EVENT 콜백 함수(dispmprt.h)

  • 아티클

디스플레이 미니포트 드라이버에 특정 ACPI 이벤트에 대해 알릴 수 있습니다.

구문

DXGKDDI_NOTIFY_ACPI_EVENT DxgkddiNotifyAcpiEvent;

NTSTATUS DxgkddiNotifyAcpiEvent(
  [in]  IN_CONST_PVOID MiniportDeviceContext,
  [in]  IN_DXGK_EVENT_TYPE EventType,
  [in]  IN_ULONG Event,
  [in]  IN_PVOID Argument,
  [out] OUT_PULONG AcpiFlags
)
{...}

매개 변수

[in] MiniportDeviceContext

디스플레이 어댑터를 나타내는 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버의 DxgkDdiAddDevice 함수는 이전에 DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

[in] EventType

이벤트 유형(DpAcpiEvent, DpPowerStateEvent, DpDockingEvent)을 제공하는 DXGK_EVENT_TYPE열거자입니다.

[in] Event

이벤트 번호입니다. 다음 표에서는 각 이벤트 유형에 대해 가능한 이벤트 번호를 나열합니다.

이벤트 유형 가능한 이벤트 번호
DpAcpiEvent 다음은 Dispmprt.h에 정의된 대로 허용되는 이벤트입니다.
  • ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY - 사용자가 주기 표시 바로 가기 키를 눌렀다는 것을 운영 체제에 알 수 있습니다.
  • ACPI_NOTIFY_DOCK_EVENT - 도킹 이벤트가 발생했음을 나타냅니다. 예를 들어 사용자가 모바일 컴퓨터를 도킹하거나 도킹 해제했습니다.
  • ACPI_NOTIFY_DEVICE_HOTPLUG - VGA 컨트롤러에 연결된 출력 디바이스의 상태 변경되었음을 나타냅니다. 예를 들어 사용자가 CRT 디스플레이를 제거하거나 VGA 포트에 연결했습니다.
  • ACPI_NOTIFY_PANEL_SWITCH - VGA 컨트롤러에 연결된 출력 디바이스 중 하나의 상태 전환되었음을 나타냅니다. 예를 들어 사용자가 활성 출력 디스플레이를 LCD에서 CRT 디스플레이 유형으로 전환했습니다.
  • ACPI_NOTIFY_VIDEO_WAKEUP - 출력 디스플레이가 다시 시작되었음을 나타냅니다. 예를 들어 사용자가 컴퓨터 디스플레이를 다시 활성화했습니다.
DpPowerStateEvent PO_CB_LID_SWITCH_STATE, PO_CB_AC_STATUS
Wdm.h에 정의됩니다.
DpDockingEvent ACPI_NOTIFY_DOCK_EVENT - 도킹 이벤트가 발생했음을 나타냅니다. 예를 들어 사용자가 모바일 컴퓨터를 도킹하거나 도킹 해제했습니다.
Dispmprt.h에 정의됩니다.

[in] Argument

이벤트에 종속된 인수에 대한 포인터입니다. 대부분의 이벤트의 경우 NULL이 됩니다. 다음 표에서는 사용 가능한 지정된 이벤트 번호에 대한 ULONG 값인 이벤트 인수를 보여 줍니다.

이벤트 번호 가능한 이벤트 인수
PO_CB_AC_STATUS 0 - 시스템이 배터리 전원을 켜고 있음을 나타냅니다.
1 - 시스템이 AC 전원에 있음을 나타냅니다.
PO_CB_LID_SWITCH_STATE 0 - 덮개를 닫고 있음을 나타냅니다.
1 - 덮개를 열고 있음을 나타냅니다.

[out] AcpiFlags

디스플레이 미니포트 드라이버가 운영 체제에 대해 수행해야 하는 요청 유형을 나타내는 값에 대한 포인터입니다. 다음 표에는 지정할 수 있는 값이 나와 있습니다.

값 요청 유형
DXGK_ACPI_CHANGE_DISPLAY_MODE 디스플레이 미니포트 드라이버는 운영 체제에 DxgkDdiRecommendFunctionalVidPn 함수를 호출한 다음 새 권장 VidPN(활성 비디오 프레젠테이션 네트워크)에 대한 모드 변경을 시작하도록 요청합니다. 예를 들어 사용자가 모드 변경을 지정한 경우 디스플레이 미니포트 드라이버가 이 요청을 수행할 수 있습니다.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN 디스플레이 미니포트 드라이버는 MiniportDeviceContext가 나타내는 디스플레이 어댑터의 자식 연결을 폴링하도록 운영 체제에 요청합니다.
DXGK_ACPI_CHAIN_NOT_HANDLED DxgkChainedAcpiEvent 형식의 이벤트가 하이브리드 불연속 드라이버에 의해 처리되지 않았으므로 하이브리드 통합 드라이버로 전송되어야 했음을 나타냅니다.

이 함수가 오류를 반환하거나 디스플레이 어댑터의 전원이 끊어지면 이 매개 변수는 무시됩니다.

반환 값

DxgkDdiNotifyAcpiEvent 는 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다.

설명

DxgkDdiNotifyAcpiEvent 는 선택적 디스플레이 미니포트 드라이버 함수입니다.

DxgkDdiNotifyAcpiEvent 를 페이징 가능으로 만들어야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 dispmprt.h
IRQL PASSIVE_LEVEL

추가 정보

DxgkCbEvalAcpiMethod