BIOS Communication for Display Drivers in Windows Vista -- May 4, 2006

bini

Abstract
9 t' l& R" C8 {: v7 tThis white paper provides detailed information about the required ACPI and display driver capabilities to support communication between the BIOS and graphics hardware on systems running the Microsoft® Windows Vista™ operating system.
0 y: s8 i! V) L2 Q% iThe current version of this paper is maintained on the Web at:
http://go.microsoft.com/fwlink/?LinkId=50987
  w! I/ {3 o) O* j2 cReferences and resources discussed here are listed at the end of this paper.
( _6 r5 ?5 m7 I  Z+ ?' SContents
Introduction        3
ACPI Methods for Display and BIOS Communications        3
ACPI Notifications        4
ACPI Method Evaluations        4
BIOS Support        4
Using ACPI Methods: Examples        5
Summary        5
  a  @2 Z+ J# s: a% fResources        6

Disclaimer
4 s4 b( r2 o3 J8 ?# e; Y0 OThis is a preliminary document and may be changed substantially prior to final commercial release of the software described herein.

: z$ F) @) M" o( r; B- HThe information contained in this document represents the current view of Microsoft Corporation on the issues discussed as of the date of publication. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information presented after the date of publication.

, k$ N" I$ E( o& KThis White Paper is for informational purposes only. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS DOCUMENT.
1 f& M; O& M' f
) `- t/ }8 j0 `3 l5 x" e' a& iComplying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation.
  `) W- o, Y' b" L8 ~7 _4 w4 o( w
Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property.
2 n+ Z, {7 s9 u1 f
Unless otherwise noted, the example companies, organizations, products, domain names, e-mail addresses, logos, people, places and events depicted herein are fictitious, and no association with any real company, organization, product, domain name, email address, logo, person, place or event is intended or should be inferred.

3 s5 O2 X; s$ }$ u' a( L© 2006 Microsoft Corporation. All rights reserved.

6 T7 u# ^# M. A# b7 e) f, Z( l- PMicrosoft, Windows, and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

  k1 A8 P/ T( e  a1 n4 k. U. EThe names of actual companies and products mentioned herein may be the trademarks of their respective owners.
/ f* s/ i3 y1 C2 U5 w5 y- m
0 _, ~, c/ J' [" c4 m; w( u! jIntroduction
5 w# x; v3 b1 I+ @+ {0 g  Y# HDisplay drivers often communicate with the system BIOS to provide advanced functionality that might depend on machine-specific or OEM-specific system BIOS implementations. Display driver and system BIOS dependencies are especially common in mobile platforms, where each manufacturer might differentiate the platform and provide value-add software and capabilities.
9 V% p6 r, S: JHistorically, display drivers without direct control of the hardware used legacy methods to communicate with the system BIOS, usually to enable mobile PC platform features such as:
7 |$ C: D; u, k2 H' |' w. ^•        Power management
•        Brightness control
•        Hotkey clone mode (for connecting a laptop to a projector)
- Z! @* A& H( T. [* Z0 ]. W- j•        Retrieval of monitor EDIDs (extended display identification data, a data block that contains monitor identification and capability information)
) h8 d: Q: d) r; D, K2 g. F
One commonly-used legacy method is the Int10 mechanism, which exercises 16-bit code in real mode. Unfortunately, legacy methods such as Int10 can cause system stability problems that are difficult to debug and fix. These stability problems manifest themselves to end users as a system that will not boot or a system that hangs unexpectedly. Fixing a problem caused by incorrect use of legacy BIOS communication mechanisms often requires a BIOS update or Windows® software patch.
Int10 communications are supported in the Windows XP display driver model (XDDM) and earlier versions of the Windows display driver model support. However, to avoid the stability problems caused by legacy BIOS communication methods, the Windows Vista display driver model (WDDM) does not support Int10 communications. It does not pass the Int10 interrupt message to the system BIOS, thus disabling any functionality that depends on Int10 communications.
  y" }$ {3 _- e! mThe WDDM is a significant evolution of the graphics driver infrastructure and is not backward compatible with XDDM drivers and previous versions of Windows. As an alternative to Int10 communications, the WDDM provides display drivers with full access to ACPI methods for the graphics adapter. ACPI (Advanced Configuration and Power Interface) is an industry specification that describes platform configuration and power management interfaces between the system BIOS and the operating system. In situations where it is necessary to use the system BIOS to control the hardware, a display driver can use the ACPI methods for the device.
% O5 H2 s' Y: Q; G2 a4 h6 iThis paper describes the ACPI methods that can be used instead of Int10 to enable communication between the display driver and the system BIOS.
  r% M) F: O, ~ACPI Methods for Display and BIOS Communications
0 {% n0 B& X( rThe WDDM enables display drivers to directly interact with the device and its children through ACPI methods and notifications. To take full advantage of the ACPI video device methods, it might be necessary to modify both the display driver and the system BIOS.
Note: In this document, any use of the term “video” refers to the graphics adapter.
( b+ I, p  b- I1 _- ]6 uACPI Notifications
A WDDM driver receives all ACPI notification events for the graphics adapter. Example ACPI notification events include:
1 t% ~2 g8 F" `( P8 L# l•        Cycle Output Device
Notifies the display driver that the state of one of the output devices attached to the VGA controller has been switched or toggled.
7 u; A- _# v7 b•        Cycle Display Output Hotkey Pressed
- T9 Y# s+ m7 B% Q  @. r, s7 d% RNotifies the display driver that the user has pressed the Cycle Display hotkey.
0 s5 N9 F+ J/ A: {2 l: l
6 {( c/ w; D+ L4 }The notification is passed directly to the WDDM driver through the DxgkDdiNotifyAcpiEvent display miniport driver function, which the display port driver calls to notify a display miniport driver about certain ACPI events. This differs from XDDM drivers, in which the graphics subsystem interprets the ACPI notification and delivers an IOCTL to the display driver.
System ACPI notifications such as lid status change or docking event are also sent to the WDDM driver using the DxgkDdiNotifyAcpiEvent function.
For information about the DxgkDdiNotifyAcpiEvent function, see the Windows Driver Kit (WDK) documentation.
3 Z' g6 J5 M- }9 W) q# aACPI Method Evaluations
WDDM drivers can execute any ACPI method on the graphics adapter or any of its children by calling the DxgkCbEvalAcpiMethod function of the Windows Vista graphics kernel subsystem. A display miniport driver calls DxgkCbEvalAcpiMethod to evaluate a specified ACPI method on a graphics adapter or on its child device.
" N8 @; R& v+ r5 @For example, to retrieve the EDID from a child output device, the WDDM driver can evaluate the _DDC ACPI method on that device.
% [- s, a4 M7 V) aFor information about the DxgkCbEvalAcpiMethod function, see the WDK documentation.
- {) b5 g" r: s9 [1 nBIOS Support
2 y- G6 |' T$ h6 U  bThe system BIOS must support all required ACPI methods for the WDDM driver to be able to communicate with the system BIOS.
4 G" S0 V: p' o1 M$ ~Many mobile PC graphics adapters are tightly integrated with the host platform and system BIOS. Therefore, graphics hardware vendors should work closely with the system manufacturer and BIOS developer for the host platform to ensure that the required ACPI methods are implemented in the system BIOS.
8 ?! p3 i1 M0 f/ hThe BIOS must implement the following ACPI methods, as applicable for specific functionality:
_ADR: Device ID
_BCL: Query for brightness levels
5 a+ P; r/ G" o6 ]6 X6 x" ?- c1 __BCM: Set brightness level
_DCS: Query display status
_DDC: EDID
6 `! l8 i/ b4 J& `3 v. @3 F% y_DOD: Enumeration of graphics adapter child devices
5 U/ j+ }$ |  T5 n7 Z_DOS: To control BIOS response to hotkeys
/ |( l8 {0 X* R  l5 r) o2 j6 o_DSS: Set display state
_PS methods for supported power states
: u* Y+ `2 G0 _9 e9 O
( r$ Z: S! q& u" pFor information about these methods, see Appendix B, “Video Extensions,” of the ACPI Specification (listed in the references at the end of this paper).
6 o" R' |5 A4 P' hUsing ACPI Methods: Examples
These examples show how the ACPI methods for functionality that might have been implemented previously using the Int10 communication mechanism.
; J# @; n! y8 ~: U" xDisplay Switching Example
5 w; g& T( c& w' r1 x3 OOn a mobile platform with an integrated panel in which the system BIOS controls signal switching and backlight power, the BIOS must support the _DSS method so that the WDDM driver can control the display state.
When the _DSS method is evaluated, it must update the system BIOS internal state, perform any signal switching required to route the signal, and set the backlight into the correct state. The _DSS method must be able to set the output state without a hotkey being pressed.
* w& G, X$ e- r% x" @: @, VThe _DOD method can be used to enumerate the child devices of the VGA controller.
" `2 }- t! Q* N0 WHotkey Clone Mode Example
" Q/ ~% e8 R& |3 n/ f" dFor a driver to be able to retrieve the hardware status of each child device of the graphics adapter, the BIOS must support the _DCS ACPI method so the WDDM driver can control the hotkeys.
: q* A7 C/ {, B$ C. u" P0 y! c6 J! kIf it is necessary to set a child output state, the _DSS method must be used to set that state.
EDID Retrieval Example
$ E! F( T1 ~# N9 Y. d' M, cThe BIOS must support the _DDC ACPI method to enable the WDDM driver to retrieve the EDID of an output device.
, P( c  Y' u! f0 h& aBrightness Control Example
$ ]/ o$ z1 t# `/ A) s; nThe BIOS must implement the _BCL and _BCM methods to support brightness control of the display control panel, so that the monitor driver supplied with Windows Vista can directly control brightness levels.
Summary
System manufacturers:
•        Ensure that the system BIOS is ACPI compliant and implements the ACPI methods required for a WDDM driver.
•        Work with Microsoft and graphics vendors to ensure compatibility with Windows Vista and the WDDM:
  O+ B1 w& e1 P5 c4 ?•        Enroll in the Windows Vista beta program to receive access to Windows Vista beta releases. Use only Windows Vista beta releases obtained from Microsoft through the beta program.
9 R* a1 c: H. {3 _1 N' d0 y•        Get WDDM drivers directly from the graphics vendor. (Microsoft is unable to re-distribute beta WDDM drivers to manufacturers.) Ensure that the beta WDDM driver from the graphics vendor is compatible with the Windows Vista beta release obtained from Microsoft.
6 J; G! W* ?! d# n- p4 Y•        Identify system functionality that depends on legacy BIOS communications (Int10) support, and implement the necessary ACPI interfaces in the system BIOS to enable this functionality for use by a WDDM driver.
•        Work with graphics vendors to ensure the required ACPI interfaces are implemented in the system BIOS to support the WDDM driver.
; H6 d& g  m6 k/ r: g% A2 b& W& e•        Validate that the system BIOS functions correctly with a WDDM driver that uses ACPI interfaces, especially for mobile platforms.
- W0 |) ?8 i$ e* b, C9 fGraphics hardware vendors:
Design your WDDM drivers to use ACPI methods instead of Int10 to communicate with the system BIOS.
BIOS vendors:
  V1 K6 x, X/ wDesign your BIOS products to be ACPI compliant and to implement the ACPI methods required for a WDDM driver.
System builders:
+ o9 y1 W1 H0 J' T- G6 dBuild systems with an ACPI-compliant BIOS that implements the ACPI methods required for a WDDM driver.
! a) [. Q1 G; @( `: D8 lResources
If you have additional questions that are not addressed by this document, please send email to directx@microsoft.com.
0 M6 m9 j- h0 _# ^ACPI/Power Management – Architecture and Driver Support
1 |7 }& J# Z2 ?  n$ K& Shttp://www.microsoft.com/whdc/sy ... ermgmt/default.mspx
+ y+ ~1 E4 d" R; G  m6 |( ?1 B# Z8 _ACPI Specification
6 T" P  E( F4 N0 p$ _http://www.acpi.info