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에 정의된 허용된 이벤트입니다.
|
| 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 |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | dispmprt.h |
| IRQL | PASSIVE_LEVEL |