Annotation of ntddk/src/video/miniport/wdvga/wdvga.c, revision 1.1

1.1     ! root        1: /*++
        !             2: 
        !             3: Copyright (c) 1992  Microsoft Corporation
        !             4: 
        !             5: Module Name:
        !             6: 
        !             7:     vga.c
        !             8: 
        !             9: Abstract:
        !            10: 
        !            11:     This is the miniport driver for the VGA card.
        !            12: 
        !            13: Environment:
        !            14: 
        !            15:     kernel mode only
        !            16: 
        !            17: Notes:
        !            18: 
        !            19: Revision History:
        !            20: 
        !            21: --*/
        !            22: 
        !            23: #include "dderror.h"
        !            24: #include "devioctl.h"
        !            25: #include "miniport.h"
        !            26: 
        !            27: #include "ntddvdeo.h"
        !            28: #include "video.h"
        !            29: #include "wdvga.h"
        !            30: #include "wddata.h"
        !            31: 
        !            32: 
        !            33: //
        !            34: // Function declarations
        !            35: //
        !            36: // Functions that start with 'VGA' are entry points for the OS port driver.
        !            37: //
        !            38: 
        !            39: VP_STATUS
        !            40: VgaFindAdapter(
        !            41:     PVOID HwDeviceExtension,
        !            42:     PVOID HwContext,
        !            43:     PWSTR ArgumentString,
        !            44:     PVIDEO_PORT_CONFIG_INFO ConfigInfo,
        !            45:     PUCHAR Again
        !            46:     );
        !            47: 
        !            48: BOOLEAN
        !            49: VgaInitialize(
        !            50:     PVOID HwDeviceExtension
        !            51:     );
        !            52: 
        !            53: BOOLEAN
        !            54: VgaStartIO(
        !            55:     PVOID HwDeviceExtension,
        !            56:     PVIDEO_REQUEST_PACKET RequestPacket
        !            57:     );
        !            58: 
        !            59: //
        !            60: // Private function prototypes.
        !            61: //
        !            62: 
        !            63: VP_STATUS
        !            64: VgaQueryAvailableModes(
        !            65:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !            66:     PVIDEO_MODE_INFORMATION ModeInformation,
        !            67:     ULONG ModeInformationSize,
        !            68:     PULONG OutputSize
        !            69:     );
        !            70: 
        !            71: VP_STATUS
        !            72: VgaQueryNumberOfAvailableModes(
        !            73:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !            74:     PVIDEO_NUM_MODES NumModes,
        !            75:     ULONG NumModesSize,
        !            76:     PULONG OutputSize
        !            77:     );
        !            78: 
        !            79: VP_STATUS
        !            80: VgaQueryCurrentMode(
        !            81:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !            82:     PVIDEO_MODE_INFORMATION ModeInformation,
        !            83:     ULONG ModeInformationSize,
        !            84:     PULONG OutputSize
        !            85:     );
        !            86: 
        !            87: VP_STATUS
        !            88: VgaSetMode(
        !            89:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !            90:     PVIDEO_MODE Mode,
        !            91:     ULONG ModeSize
        !            92:     );
        !            93: 
        !            94: VP_STATUS
        !            95: VgaLoadAndSetFont(
        !            96:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !            97:     PVIDEO_LOAD_FONT_INFORMATION FontInformation,
        !            98:     ULONG FontInformationSize
        !            99:     );
        !           100: 
        !           101: VP_STATUS
        !           102: VgaQueryCursorPosition(
        !           103:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           104:     PVIDEO_CURSOR_POSITION CursorPosition,
        !           105:     ULONG CursorPositionSize,
        !           106:     PULONG OutputSize
        !           107:     );
        !           108: 
        !           109: VP_STATUS
        !           110: VgaSetCursorPosition(
        !           111:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           112:     PVIDEO_CURSOR_POSITION CursorPosition,
        !           113:     ULONG CursorPositionSize
        !           114:     );
        !           115: 
        !           116: VP_STATUS
        !           117: VgaQueryCursorAttributes(
        !           118:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           119:     PVIDEO_CURSOR_ATTRIBUTES CursorAttributes,
        !           120:     ULONG CursorAttributesSize,
        !           121:     PULONG OutputSize
        !           122:     );
        !           123: 
        !           124: VP_STATUS
        !           125: VgaSetCursorAttributes(
        !           126:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           127:     PVIDEO_CURSOR_ATTRIBUTES CursorAttributes,
        !           128:     ULONG CursorAttributesSize
        !           129:     );
        !           130: 
        !           131: BOOLEAN
        !           132: VgaIsPresent(
        !           133:     PHW_DEVICE_EXTENSION HwDeviceExtension
        !           134:     );
        !           135: 
        !           136: BOOLEAN
        !           137: WdIsPresent(
        !           138:     PHW_DEVICE_EXTENSION HwDeviceExtension
        !           139:     );
        !           140: 
        !           141: VOID
        !           142: VgaSizeMemory(
        !           143:     PHW_DEVICE_EXTENSION HwDeviceExtension
        !           144:     );
        !           145: 
        !           146: VOID
        !           147: VgaInterpretCmdStream(
        !           148:     PVOID HwDeviceExtension,
        !           149:     PUSHORT pusCmdStream
        !           150:     );
        !           151: 
        !           152: VP_STATUS
        !           153: VgaSetPaletteReg(
        !           154:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           155:     PVIDEO_PALETTE_DATA PaletteBuffer,
        !           156:     ULONG PaletteBufferSize
        !           157:     );
        !           158: 
        !           159: VP_STATUS
        !           160: VgaSetColorLookup(
        !           161:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           162:     PVIDEO_CLUT ClutBuffer,
        !           163:     ULONG ClutBufferSize
        !           164:     );
        !           165: 
        !           166: VP_STATUS
        !           167: VgaRestoreHardwareState(
        !           168:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           169:     PVIDEO_HARDWARE_STATE HardwareState,
        !           170:     ULONG HardwareStateSize
        !           171:     );
        !           172: 
        !           173: VP_STATUS
        !           174: VgaSaveHardwareState(
        !           175:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           176:     PVIDEO_HARDWARE_STATE HardwareState,
        !           177:     ULONG HardwareStateSize,
        !           178:     PULONG OutputSize
        !           179:     );
        !           180: 
        !           181: VP_STATUS
        !           182: VgaGetBankSelectCode(
        !           183:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           184:     PVIDEO_BANK_SELECT BankSelect,
        !           185:     ULONG BankSelectSize,
        !           186:     PULONG OutputSize
        !           187:     );
        !           188: 
        !           189: VOID
        !           190: VgaValidateModes(
        !           191:     PHW_DEVICE_EXTENSION HwDeviceExtension
        !           192:     );
        !           193: 
        !           194: 
        !           195: 
        !           196: ULONG
        !           197: DriverEntry(
        !           198:     PVOID Context1,
        !           199:     PVOID Context2
        !           200:     )
        !           201: 
        !           202: /*++
        !           203: 
        !           204: Routine Description:
        !           205: 
        !           206:     Installable driver initialization entry point.
        !           207:     This entry point is called directly by the I/O system.
        !           208: 
        !           209: Arguments:
        !           210: 
        !           211:     Context1 - First context value passed by the operating system. This is
        !           212:         the value with which the miniport driver calls VideoPortInitialize().
        !           213: 
        !           214:     Context2 - Second context value passed by the operating system. This is
        !           215:         the value with which the miniport driver calls VideoPortInitialize().
        !           216: 
        !           217: Return Value:
        !           218: 
        !           219:     Status from VideoPortInitialize()
        !           220: 
        !           221: --*/
        !           222: 
        !           223: {
        !           224: 
        !           225:     VIDEO_HW_INITIALIZATION_DATA hwInitData;
        !           226:     ULONG status;
        !           227:     ULONG initializationStatus;
        !           228: 
        !           229:     //
        !           230:     // Zero out structure.
        !           231:     //
        !           232: 
        !           233:     VideoPortZeroMemory(&hwInitData, sizeof(VIDEO_HW_INITIALIZATION_DATA));
        !           234: 
        !           235:     //
        !           236:     // Specify sizes of structure and extension.
        !           237:     //
        !           238: 
        !           239:     hwInitData.HwInitDataSize = sizeof(VIDEO_HW_INITIALIZATION_DATA);
        !           240: 
        !           241:     //
        !           242:     // Set entry points.
        !           243:     //
        !           244: 
        !           245:     hwInitData.HwFindAdapter = VgaFindAdapter;
        !           246:     hwInitData.HwInitialize = VgaInitialize;
        !           247:     hwInitData.HwInterrupt = NULL;
        !           248:     hwInitData.HwStartIO = VgaStartIO;
        !           249: 
        !           250:     //
        !           251:     // Determine the size we require for the device extension.
        !           252:     //
        !           253: 
        !           254:     hwInitData.HwDeviceExtensionSize = sizeof(HW_DEVICE_EXTENSION);
        !           255: 
        !           256:     //
        !           257:     // Always start with parameters for device0 in this case.
        !           258:     // We can leave it like this since we know we will only ever find one
        !           259:     // VGA type adapter in a machine.
        !           260:     //
        !           261: 
        !           262: //    hwInitData.StartingDeviceNumber = 0;
        !           263: 
        !           264:     //
        !           265:     // Once all the relevant information has been stored, call the video
        !           266:     // port driver to do the initialization.
        !           267:     // For this device we will repeat this call three times, for ISA, EISA
        !           268:     // and MCA.
        !           269:     // We will return the minimum of all return values.
        !           270:     //
        !           271: 
        !           272:     hwInitData.AdapterInterfaceType = Isa;
        !           273: 
        !           274:     initializationStatus = VideoPortInitialize(Context1,
        !           275:                                                Context2,
        !           276:                                                &hwInitData,
        !           277:                                                NULL);
        !           278: 
        !           279:     hwInitData.AdapterInterfaceType = Eisa;
        !           280: 
        !           281:     status = VideoPortInitialize(Context1,
        !           282:                                  Context2,
        !           283:                                  &hwInitData,
        !           284:                                  NULL);
        !           285: 
        !           286:     if (initializationStatus > status) {
        !           287:         initializationStatus = status;
        !           288:     }
        !           289: 
        !           290:     hwInitData.AdapterInterfaceType = MicroChannel;
        !           291: 
        !           292:     status = VideoPortInitialize(Context1,
        !           293:                                  Context2,
        !           294:                                  &hwInitData,
        !           295:                                  NULL);
        !           296: 
        !           297:     if (initializationStatus > status) {
        !           298:         initializationStatus = status;
        !           299:     }
        !           300: 
        !           301:     return initializationStatus;
        !           302: 
        !           303: } // end DriverEntry()
        !           304: 
        !           305: VP_STATUS
        !           306: VgaFindAdapter(
        !           307:     PVOID HwDeviceExtension,
        !           308:     PVOID HwContext,
        !           309:     PWSTR ArgumentString,
        !           310:     PVIDEO_PORT_CONFIG_INFO ConfigInfo,
        !           311:     PUCHAR Again
        !           312:     )
        !           313: 
        !           314: /*++
        !           315: 
        !           316: Routine Description:
        !           317: 
        !           318:     This routine is called to determine if the adapter for this driver
        !           319:     is present in the system.
        !           320:     If it is present, the function fills out some information describing
        !           321:     the adapter.
        !           322: 
        !           323: Arguments:
        !           324: 
        !           325:     HwDeviceExtension - Supplies the miniport driver's adapter storage. This
        !           326:         storage is initialized to zero before this call.
        !           327: 
        !           328:     HwContext - Supplies the context value which was passed to
        !           329:         VideoPortInitialize().
        !           330: 
        !           331:     ArgumentString - Supplies a NULL terminated ASCII string. This string
        !           332:         originates from the user.
        !           333: 
        !           334:     ConfigInfo - Returns the configuration information structure which is
        !           335:         filled by the miniport driver. This structure is initialized with
        !           336:         any known configuration information (such as SystemIoBusNumber) by
        !           337:         the port driver. Where possible, drivers should have one set of
        !           338:         defaults which do not require any supplied configuration information.
        !           339: 
        !           340:     Again - Indicates if the miniport driver wants the port driver to call
        !           341:         its VIDEO_HW_FIND_ADAPTER function again with a new device extension
        !           342:         and the same config info. This is used by the miniport drivers which
        !           343:         can search for several adapters on a bus.
        !           344: 
        !           345: Return Value:
        !           346: 
        !           347:     This routine must return:
        !           348: 
        !           349:     NO_ERROR - Indicates a host adapter was found and the
        !           350:         configuration information was successfully determined.
        !           351: 
        !           352:     ERROR_INVALID_PARAMETER - Indicates an adapter was found but there was an
        !           353:         error obtaining the configuration information. If possible an error
        !           354:         should be logged.
        !           355: 
        !           356:     ERROR_DEV_NOT_EXIST - Indicates no host adapter was found for the
        !           357:         supplied configuration information.
        !           358: 
        !           359: --*/
        !           360: 
        !           361: {
        !           362: 
        !           363:     PHW_DEVICE_EXTENSION hwDeviceExtension = HwDeviceExtension;
        !           364:     VP_STATUS status;
        !           365: 
        !           366:     //
        !           367:     // Make sure the size of the structure is at least as large as what we
        !           368:     // are expecting (check version of the config info structure).
        !           369:     //
        !           370: 
        !           371:     if (ConfigInfo->Length < sizeof(VIDEO_PORT_CONFIG_INFO)) {
        !           372: 
        !           373:         return ERROR_INVALID_PARAMETER;
        !           374: 
        !           375:     }
        !           376: 
        !           377:     //
        !           378:     // No interrupt information is necessary.
        !           379:     //
        !           380: 
        !           381:     //
        !           382:     // Check to see if there is a hardware resource conflict.
        !           383:     // Start by including the exted register. If that fails, then only use
        !           384:     // the normal registers.
        !           385:     //
        !           386: 
        !           387:     hwDeviceExtension->ExtendedRegisters = TRUE;
        !           388: 
        !           389:     status = VideoPortVerifyAccessRanges(hwDeviceExtension,
        !           390:                                          NUM_WD_ACCESS_RANGES,
        !           391:                                          VgaAccessRange);
        !           392: 
        !           393:     if (status != NO_ERROR) {
        !           394: 
        !           395:         hwDeviceExtension->ExtendedRegisters = FALSE;
        !           396: 
        !           397:         status = VideoPortVerifyAccessRanges(hwDeviceExtension,
        !           398:                                              NUM_VGA_ACCESS_RANGES,
        !           399:                                              VgaAccessRange);
        !           400: 
        !           401:         if (status != NO_ERROR) {
        !           402: 
        !           403:             return status;
        !           404: 
        !           405:         }
        !           406:     }
        !           407: 
        !           408:     //
        !           409:     // Get logical IO port addresses.
        !           410:     //
        !           411: 
        !           412:     if ( (hwDeviceExtension->IOAddress =
        !           413:               VideoPortGetDeviceBase(hwDeviceExtension,
        !           414:                                      VgaAccessRange->RangeStart,
        !           415:                                      VGA_MAX_IO_PORT - VGA_BASE_IO_PORT + 1,
        !           416:                                      TRUE)) == NULL) {
        !           417: 
        !           418:         VideoDebugPrint((2, "VgaFindAdapter - Fail to get io address\n"));
        !           419: 
        !           420:         return ERROR_INVALID_PARAMETER;
        !           421: 
        !           422:     }
        !           423: 
        !           424:     //
        !           425:     // Determine whether a VGA is present.
        !           426:     //
        !           427: 
        !           428:     if (!VgaIsPresent(hwDeviceExtension)) {
        !           429: 
        !           430:         return ERROR_DEV_NOT_EXIST;
        !           431: 
        !           432:     }
        !           433: 
        !           434:     //
        !           435:     // Determine whether a WDVGA chipset is present.
        !           436:     //
        !           437: 
        !           438:     if (!WdIsPresent(hwDeviceExtension)) {
        !           439: 
        !           440:         return ERROR_DEV_NOT_EXIST;
        !           441: 
        !           442:     }
        !           443: 
        !           444:     //
        !           445:     // Pass a pointer to the emulator range we are using.
        !           446:     //
        !           447: 
        !           448:     ConfigInfo->NumEmulatorAccessEntries = VGA_NUM_EMULATOR_ACCESS_ENTRIES;
        !           449:     ConfigInfo->EmulatorAccessEntries = VgaEmulatorAccessEntries;
        !           450:     ConfigInfo->EmulatorAccessEntriesContext = (ULONG) hwDeviceExtension;
        !           451: 
        !           452:     ConfigInfo->VdmPhysicalVideoMemoryAddress.LowPart = MEM_VGA;
        !           453:     ConfigInfo->VdmPhysicalVideoMemoryAddress.HighPart = 0x00000000;
        !           454:     ConfigInfo->VdmPhysicalVideoMemoryLength = MEM_VGA_SIZE;
        !           455: 
        !           456:     //
        !           457:     // Minimum size of the buffer required to store the hardware state
        !           458:     // information returned by IOCTL_VIDEO_SAVE_HARDWARE_STATE.
        !           459:     //
        !           460: 
        !           461:     ConfigInfo->HardwareStateSize = VGA_TOTAL_STATE_SIZE;
        !           462: 
        !           463:     //
        !           464:     // Video memory information
        !           465:     //
        !           466: 
        !           467:     hwDeviceExtension->PhysicalVideoMemoryBase.HighPart = 0x00000000;
        !           468:     hwDeviceExtension->PhysicalVideoMemoryBase.LowPart = MEM_VGA;
        !           469:     hwDeviceExtension->PhysicalVideoMemoryLength = MEM_VGA_SIZE;
        !           470: 
        !           471:     //
        !           472:     // Map the video memory into the system virtual address space so we can
        !           473:     // clear it out and use it for save and restore.
        !           474:     //
        !           475: 
        !           476:     if ( (hwDeviceExtension->VideoMemoryAddress =
        !           477:               VideoPortGetDeviceBase(hwDeviceExtension,
        !           478:               hwDeviceExtension->PhysicalVideoMemoryBase,
        !           479:               hwDeviceExtension->PhysicalVideoMemoryLength, FALSE)) == NULL) {
        !           480: 
        !           481:         VideoDebugPrint((1, "VgaFindAdapter - Fail to get memory address\n"));
        !           482: 
        !           483:         return ERROR_INVALID_PARAMETER;
        !           484: 
        !           485:     }
        !           486: 
        !           487:     //
        !           488:     // Indicate we do not wish to be called again for another initialization.
        !           489:     //
        !           490: 
        !           491:     *Again = 0;
        !           492: 
        !           493:     //
        !           494:     // Indicate a successful completion status.
        !           495:     //
        !           496: 
        !           497:     return NO_ERROR;
        !           498: 
        !           499: } // VgaFindAdapter()
        !           500: 
        !           501: BOOLEAN
        !           502: VgaInitialize(
        !           503:     PVOID HwDeviceExtension
        !           504:     )
        !           505: 
        !           506: /*++
        !           507: 
        !           508: Routine Description:
        !           509: 
        !           510:     This routine does one time initialization of the device.
        !           511: 
        !           512: Arguments:
        !           513: 
        !           514:     HwDeviceExtension - Pointer to the miniport driver's adapter information.
        !           515: 
        !           516: Return Value:
        !           517: 
        !           518:     None.
        !           519: 
        !           520: --*/
        !           521: 
        !           522: {
        !           523:     PHW_DEVICE_EXTENSION hwDeviceExtension = HwDeviceExtension;
        !           524: 
        !           525:     //
        !           526:     // set up the default cursor position and type.
        !           527:     //
        !           528: 
        !           529:     hwDeviceExtension->CursorPosition.Column = 0;
        !           530:     hwDeviceExtension->CursorPosition.Row = 0;
        !           531:     hwDeviceExtension->CursorTopScanLine = 0;
        !           532:     hwDeviceExtension->CursorBottomScanLine = 31;
        !           533:     hwDeviceExtension->CursorEnable = TRUE;
        !           534: 
        !           535:     return TRUE;
        !           536: 
        !           537: } // VgaInitialize()
        !           538: 
        !           539: BOOLEAN
        !           540: VgaStartIO(
        !           541:     PVOID HwDeviceExtension,
        !           542:     PVIDEO_REQUEST_PACKET RequestPacket
        !           543:     )
        !           544: 
        !           545: /*++
        !           546: 
        !           547: Routine Description:
        !           548: 
        !           549:     This routine is the main execution routine for the miniport driver. It
        !           550:     acceptss a Video Request Packet, performs the request, and then returns
        !           551:     with the appropriate status.
        !           552: 
        !           553: Arguments:
        !           554: 
        !           555:     HwDeviceExtension - Pointer to the miniport driver's adapter information.
        !           556: 
        !           557:     RequestPacket - Pointer to the video request packet. This structure
        !           558:         contains all the parameters passed to the VideoIoControl function.
        !           559: 
        !           560: Return Value:
        !           561: 
        !           562:     This routine will return error codes from the various support routines
        !           563:     and will also return ERROR_INSUFFICIENT_BUFFER for incorrectly sized
        !           564:     buffers and ERROR_INVALID_FUNCTION for unsupported functions.
        !           565: 
        !           566: --*/
        !           567: 
        !           568: {
        !           569:     PHW_DEVICE_EXTENSION hwDeviceExtension = HwDeviceExtension;
        !           570:     VP_STATUS status;
        !           571:     VIDEO_MODE videoMode;
        !           572:     PVIDEO_MEMORY_INFORMATION memoryInformation;
        !           573:     ULONG inIoSpace;
        !           574: 
        !           575:     //
        !           576:     // Switch on the IoContolCode in the RequestPacket. It indicates which
        !           577:     // function must be performed by the driver.
        !           578:     //
        !           579: 
        !           580:     switch (RequestPacket->IoControlCode) {
        !           581: 
        !           582: 
        !           583:     case IOCTL_VIDEO_MAP_VIDEO_MEMORY:
        !           584: 
        !           585:         VideoDebugPrint((2, "VgaStartIO - MapVideoMemory\n"));
        !           586: 
        !           587:         if ( (RequestPacket->OutputBufferLength <
        !           588:               (RequestPacket->StatusBlock->Information =
        !           589:                                      sizeof(VIDEO_MEMORY_INFORMATION))) ||
        !           590:              (RequestPacket->InputBufferLength < sizeof(VIDEO_MEMORY)) ) {
        !           591: 
        !           592:             status = ERROR_INSUFFICIENT_BUFFER;
        !           593:         }
        !           594: 
        !           595:         memoryInformation = RequestPacket->OutputBuffer;
        !           596: 
        !           597:         memoryInformation->VideoRamBase = ((PVIDEO_MEMORY)
        !           598:                 (RequestPacket->InputBuffer))->RequestedVirtualAddress;
        !           599: 
        !           600:         memoryInformation->VideoRamLength =
        !           601:                 hwDeviceExtension->PhysicalVideoMemoryLength;
        !           602: 
        !           603:         inIoSpace = 0;
        !           604: 
        !           605:         status = VideoPortMapMemory(hwDeviceExtension,
        !           606:                                     hwDeviceExtension->PhysicalVideoMemoryBase,
        !           607:                                     &(memoryInformation->VideoRamLength),
        !           608:                                     &inIoSpace,
        !           609:                                     &(memoryInformation->VideoRamBase));
        !           610: 
        !           611:         memoryInformation->FrameBufferBase =
        !           612:                 ((PUCHAR) (memoryInformation->VideoRamBase)) +
        !           613:                 (hwDeviceExtension->PhysicalFrameBase.LowPart -
        !           614:                 hwDeviceExtension->PhysicalVideoMemoryBase.LowPart);
        !           615: 
        !           616:         memoryInformation->FrameBufferLength =
        !           617:             hwDeviceExtension->PhysicalFrameLength;
        !           618: 
        !           619:         break;
        !           620: 
        !           621: 
        !           622:     case IOCTL_VIDEO_UNMAP_VIDEO_MEMORY:
        !           623: 
        !           624:         VideoDebugPrint((2, "VgaStartIO - UnMapVideoMemory\n"));
        !           625: 
        !           626:         if (RequestPacket->InputBufferLength < sizeof(VIDEO_MEMORY)) {
        !           627: 
        !           628:             status = ERROR_INSUFFICIENT_BUFFER;
        !           629:         }
        !           630: 
        !           631:         status = VideoPortUnmapMemory(hwDeviceExtension,
        !           632:                                       ((PVIDEO_MEMORY)
        !           633:                                        (RequestPacket->InputBuffer))->
        !           634:                                            RequestedVirtualAddress,
        !           635:                                       0);
        !           636: 
        !           637:         break;
        !           638: 
        !           639: 
        !           640:     case IOCTL_VIDEO_QUERY_AVAIL_MODES:
        !           641: 
        !           642:         VideoDebugPrint((2, "VgaStartIO - QueryAvailableModes\n"));
        !           643: 
        !           644:         status = VgaQueryAvailableModes(HwDeviceExtension,
        !           645:                                         (PVIDEO_MODE_INFORMATION)
        !           646:                                             RequestPacket->OutputBuffer,
        !           647:                                         RequestPacket->OutputBufferLength,
        !           648:                                         &RequestPacket->StatusBlock->Information);
        !           649: 
        !           650:         break;
        !           651: 
        !           652: 
        !           653:     case IOCTL_VIDEO_QUERY_NUM_AVAIL_MODES:
        !           654: 
        !           655:         VideoDebugPrint((2, "VgaStartIO - QueryNumAvailableModes\n"));
        !           656: 
        !           657:         status = VgaQueryNumberOfAvailableModes(HwDeviceExtension,
        !           658:                                                 (PVIDEO_NUM_MODES)
        !           659:                                                     RequestPacket->OutputBuffer,
        !           660:                                                 RequestPacket->OutputBufferLength,
        !           661:                                                 &RequestPacket->StatusBlock->Information);
        !           662: 
        !           663:         break;
        !           664: 
        !           665: 
        !           666:     case IOCTL_VIDEO_QUERY_CURRENT_MODE:
        !           667: 
        !           668:         VideoDebugPrint((2, "VgaStartIO - QueryCurrentMode\n"));
        !           669: 
        !           670:         status = VgaQueryCurrentMode(HwDeviceExtension,
        !           671:                                      (PVIDEO_MODE_INFORMATION) RequestPacket->OutputBuffer,
        !           672:                                      RequestPacket->OutputBufferLength,
        !           673:                                      &RequestPacket->StatusBlock->Information);
        !           674: 
        !           675:         break;
        !           676: 
        !           677: 
        !           678:     case IOCTL_VIDEO_SET_CURRENT_MODE:
        !           679: 
        !           680:         VideoDebugPrint((2, "VgaStartIO - SetCurrentModes\n"));
        !           681: 
        !           682:         status = VgaSetMode(HwDeviceExtension,
        !           683:                             (PVIDEO_MODE) RequestPacket->InputBuffer,
        !           684:                             RequestPacket->InputBufferLength);
        !           685: 
        !           686:         break;
        !           687: 
        !           688: 
        !           689:     case IOCTL_VIDEO_RESET_DEVICE:
        !           690: 
        !           691:         VideoDebugPrint((2, "VgaStartIO - Reset Device\n"));
        !           692: 
        !           693:         videoMode.RequestedMode = DEFAULT_MODE;
        !           694: 
        !           695:         status = VgaSetMode(HwDeviceExtension,
        !           696:                             (PVIDEO_MODE) &videoMode,
        !           697:                             sizeof(videoMode));
        !           698: 
        !           699:         break;
        !           700: 
        !           701: 
        !           702:     case IOCTL_VIDEO_LOAD_AND_SET_FONT:
        !           703: 
        !           704:         VideoDebugPrint((2, "VgaStartIO - LoadAndSetFont\n"));
        !           705: 
        !           706:         status = VgaLoadAndSetFont(HwDeviceExtension,
        !           707:                                    (PVIDEO_LOAD_FONT_INFORMATION) RequestPacket->InputBuffer,
        !           708:                                    RequestPacket->InputBufferLength);
        !           709: 
        !           710:         break;
        !           711: 
        !           712: 
        !           713:     case IOCTL_VIDEO_QUERY_CURSOR_POSITION:
        !           714: 
        !           715:         VideoDebugPrint((2, "VgaStartIO - QueryCursorPosition\n"));
        !           716: 
        !           717:         status = VgaQueryCursorPosition(HwDeviceExtension,
        !           718:                                         (PVIDEO_CURSOR_POSITION) RequestPacket->OutputBuffer,
        !           719:                                         RequestPacket->OutputBufferLength,
        !           720:                                         &RequestPacket->StatusBlock->Information);
        !           721: 
        !           722:         break;
        !           723: 
        !           724: 
        !           725:     case IOCTL_VIDEO_SET_CURSOR_POSITION:
        !           726: 
        !           727:         VideoDebugPrint((2, "VgaStartIO - SetCursorPosition\n"));
        !           728: 
        !           729:         status = VgaSetCursorPosition(HwDeviceExtension,
        !           730:                                       (PVIDEO_CURSOR_POSITION)
        !           731:                                           RequestPacket->InputBuffer,
        !           732:                                       RequestPacket->InputBufferLength);
        !           733: 
        !           734:         break;
        !           735: 
        !           736: 
        !           737:     case IOCTL_VIDEO_QUERY_CURSOR_ATTR:
        !           738: 
        !           739:         VideoDebugPrint((2, "VgaStartIO - QueryCursorAttributes\n"));
        !           740: 
        !           741:         status = VgaQueryCursorAttributes(HwDeviceExtension,
        !           742:                                           (PVIDEO_CURSOR_ATTRIBUTES) RequestPacket->OutputBuffer,
        !           743:                                           RequestPacket->OutputBufferLength,
        !           744:                                           &RequestPacket->StatusBlock->Information);
        !           745: 
        !           746:         break;
        !           747: 
        !           748: 
        !           749:     case IOCTL_VIDEO_SET_CURSOR_ATTR:
        !           750: 
        !           751:         VideoDebugPrint((2, "VgaStartIO - SetCursorAttributes\n"));
        !           752: 
        !           753:         status = VgaSetCursorAttributes(HwDeviceExtension,
        !           754:                                         (PVIDEO_CURSOR_ATTRIBUTES) RequestPacket->InputBuffer,
        !           755:                                         RequestPacket->InputBufferLength);
        !           756: 
        !           757:         break;
        !           758: 
        !           759: 
        !           760:     case IOCTL_VIDEO_SET_PALETTE_REGISTERS:
        !           761: 
        !           762:         VideoDebugPrint((2, "VgaStartIO - SetPaletteRegs\n"));
        !           763: 
        !           764:         status = VgaSetPaletteReg(HwDeviceExtension,
        !           765:                                   (PVIDEO_PALETTE_DATA) RequestPacket->InputBuffer,
        !           766:                                   RequestPacket->InputBufferLength);
        !           767: 
        !           768:         break;
        !           769: 
        !           770: 
        !           771:     case IOCTL_VIDEO_SET_COLOR_REGISTERS:
        !           772: 
        !           773:         VideoDebugPrint((2, "VgaStartIO - SetColorRegs\n"));
        !           774: 
        !           775:         status = VgaSetColorLookup(HwDeviceExtension,
        !           776:                                    (PVIDEO_CLUT) RequestPacket->InputBuffer,
        !           777:                                    RequestPacket->InputBufferLength);
        !           778: 
        !           779:         break;
        !           780: 
        !           781: 
        !           782:     case IOCTL_VIDEO_ENABLE_VDM:
        !           783: 
        !           784:         VideoDebugPrint((2, "VgaStartIO - EnableVDM\n"));
        !           785: 
        !           786:         hwDeviceExtension->TrappedValidatorCount = 0;
        !           787:         hwDeviceExtension->SequencerAddressValue = 0;
        !           788: 
        !           789:         hwDeviceExtension->CurrentNumVdmAccessRanges =
        !           790:             NUM_MINIMAL_VGA_VALIDATOR_ACCESS_RANGE;
        !           791:         hwDeviceExtension->CurrentVdmAccessRange =
        !           792:             MinimalVgaValidatorAccessRange;
        !           793: 
        !           794:         VideoPortSetTrappedEmulatorPorts(hwDeviceExtension,
        !           795:                                          hwDeviceExtension->CurrentNumVdmAccessRanges,
        !           796:                                          hwDeviceExtension->CurrentVdmAccessRange);
        !           797: 
        !           798:         status = NO_ERROR;
        !           799: 
        !           800:         break;
        !           801: 
        !           802: 
        !           803:     case IOCTL_VIDEO_RESTORE_HARDWARE_STATE:
        !           804: 
        !           805:         VideoDebugPrint((2, "VgaStartIO - RestoreHardwareState\n"));
        !           806: 
        !           807:         status = VgaRestoreHardwareState(HwDeviceExtension,
        !           808:                                          (PVIDEO_HARDWARE_STATE) RequestPacket->InputBuffer,
        !           809:                                          RequestPacket->InputBufferLength);
        !           810: 
        !           811:         break;
        !           812: 
        !           813: 
        !           814:     case IOCTL_VIDEO_SAVE_HARDWARE_STATE:
        !           815: 
        !           816:         VideoDebugPrint((2, "VgaStartIO - SaveHardwareState\n"));
        !           817: 
        !           818:         status = VgaSaveHardwareState(HwDeviceExtension,
        !           819:                                       (PVIDEO_HARDWARE_STATE) RequestPacket->OutputBuffer,
        !           820:                                       RequestPacket->OutputBufferLength,
        !           821:                                       &RequestPacket->StatusBlock->Information);
        !           822: 
        !           823:         break;
        !           824: 
        !           825:     case IOCTL_VIDEO_GET_BANK_SELECT_CODE:
        !           826: 
        !           827:         VideoDebugPrint((2, "VgaStartIO - GetBankSelectCode\n"));
        !           828: 
        !           829:         status = VgaGetBankSelectCode(HwDeviceExtension,
        !           830:                                         (PVIDEO_BANK_SELECT) RequestPacket->OutputBuffer,
        !           831:                                         RequestPacket->OutputBufferLength,
        !           832:                                         &RequestPacket->StatusBlock->Information);
        !           833: 
        !           834:         break;
        !           835: 
        !           836: 
        !           837:     //
        !           838:     // if we get here, an invalid IoControlCode was specified.
        !           839:     //
        !           840: 
        !           841:     default:
        !           842: 
        !           843:         VideoDebugPrint((1, "Fell through vga startIO routine - invalid command\n"));
        !           844: 
        !           845:         status = ERROR_INVALID_FUNCTION;
        !           846: 
        !           847:         break;
        !           848: 
        !           849:     }
        !           850: 
        !           851:     RequestPacket->StatusBlock->Status = status;
        !           852: 
        !           853:     return TRUE;
        !           854: 
        !           855: } // VgaStartIO()
        !           856: 
        !           857: //
        !           858: // private routines
        !           859: //
        !           860: 
        !           861: VP_STATUS
        !           862: VgaLoadAndSetFont(
        !           863:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !           864:     PVIDEO_LOAD_FONT_INFORMATION FontInformation,
        !           865:     ULONG FontInformationSize
        !           866:     )
        !           867: 
        !           868: /*++
        !           869: 
        !           870: Routine Description:
        !           871: 
        !           872:     Takes a buffer containing a user-defined font and loads it into the
        !           873:     VGA soft font memory and programs the VGA to the appropriate character
        !           874:     cell size.
        !           875: 
        !           876: Arguments:
        !           877: 
        !           878:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !           879: 
        !           880:     FontInformation - Pointer to the structure containing the information
        !           881:         about the loadable ROM font to be set.
        !           882: 
        !           883:     FontInformationSize - Length of the input buffer supplied by the user.
        !           884: 
        !           885: Return Value:
        !           886: 
        !           887:     NO_ERROR - information returned successfully
        !           888: 
        !           889:     ERROR_INSUFFICIENT_BUFFER - input buffer not large enough for input data.
        !           890: 
        !           891:     ERROR_INVALID_PARAMETER - invalid video mode
        !           892: 
        !           893: --*/
        !           894: 
        !           895: {
        !           896:     PUCHAR destination;
        !           897:     PUCHAR source;
        !           898:     USHORT width;
        !           899:     ULONG i;
        !           900: 
        !           901:     //
        !           902:     // Text mode only; If we are in a graphics mode, return an error
        !           903:     //
        !           904: 
        !           905:     if (HwDeviceExtension->CurrentMode->fbType & VIDEO_MODE_GRAPHICS) {
        !           906: 
        !           907:         return ERROR_INVALID_PARAMETER;
        !           908: 
        !           909:     }
        !           910: 
        !           911:     //
        !           912:     // Check if the size of the data in the input buffer is large enough
        !           913:     // and that it contains all the data.
        !           914:     //
        !           915: 
        !           916:     if ( (FontInformationSize < sizeof(VIDEO_LOAD_FONT_INFORMATION)) ||
        !           917:          (FontInformationSize < sizeof(VIDEO_LOAD_FONT_INFORMATION) +
        !           918:                         sizeof(UCHAR) * (FontInformation->FontSize - 1)) ) {
        !           919: 
        !           920:         return ERROR_INSUFFICIENT_BUFFER;
        !           921: 
        !           922:     }
        !           923: 
        !           924:     //
        !           925:     // Check for the width and height of the font
        !           926:     //
        !           927: 
        !           928:     if ( ((FontInformation->WidthInPixels != 8) &&
        !           929:           (FontInformation->WidthInPixels != 9)) ||
        !           930:          (FontInformation->HeightInPixels > 32) ) {
        !           931: 
        !           932:         return ERROR_INVALID_PARAMETER;
        !           933: 
        !           934:     }
        !           935: 
        !           936:     //
        !           937:     // Check the size of the font buffer is the right size for the size
        !           938:     // font being passed down.
        !           939:     //
        !           940: 
        !           941:     if (FontInformation->FontSize < FontInformation->HeightInPixels * 256 *
        !           942:                                     sizeof(UCHAR) ) {
        !           943: 
        !           944:         return ERROR_INSUFFICIENT_BUFFER;
        !           945: 
        !           946:     }
        !           947: 
        !           948:     //
        !           949:     // Since the font parameters are valid, store the parameters in the
        !           950:     // device extension and load the font.
        !           951:     //
        !           952: 
        !           953:     HwDeviceExtension->FontPelRows = FontInformation->HeightInPixels;
        !           954:     HwDeviceExtension->FontPelColumns = FontInformation->WidthInPixels;
        !           955: 
        !           956:     HwDeviceExtension->CurrentMode->row =
        !           957:         HwDeviceExtension->CurrentMode->vres / HwDeviceExtension->FontPelRows;
        !           958: 
        !           959:     width =
        !           960:       HwDeviceExtension->CurrentMode->hres / HwDeviceExtension->FontPelColumns;
        !           961: 
        !           962:     if (width < (USHORT)HwDeviceExtension->CurrentMode->col) {
        !           963: 
        !           964:         HwDeviceExtension->CurrentMode->col = width;
        !           965: 
        !           966:     }
        !           967: 
        !           968:     source = &(FontInformation->Font[0]);
        !           969: 
        !           970:     //
        !           971:     // Set up the destination and source pointers for the font
        !           972:     //
        !           973: 
        !           974:     destination = (PUCHAR)HwDeviceExtension->VideoMemoryAddress;
        !           975: 
        !           976:     //
        !           977:     // Map font buffer at A0000
        !           978:     //
        !           979: 
        !           980:     VgaInterpretCmdStream(HwDeviceExtension, EnableA000Data);
        !           981: 
        !           982:     //
        !           983:     // Move the font to its destination
        !           984:     //
        !           985: 
        !           986:     for (i = 1; i <= 256; i++) {
        !           987: 
        !           988:         VideoPortWriteRegisterBufferUchar(destination,
        !           989:                                           source,
        !           990:                                           FontInformation->HeightInPixels);
        !           991: 
        !           992:         destination += 32;
        !           993:         source += FontInformation->HeightInPixels;
        !           994: 
        !           995:     }
        !           996: 
        !           997:     VgaInterpretCmdStream(HwDeviceExtension, DisableA000Color);
        !           998: 
        !           999:     //
        !          1000:     // Restore to a text mode.
        !          1001:     //
        !          1002: 
        !          1003:     //
        !          1004:     // Set Height of font.
        !          1005:     //
        !          1006: 
        !          1007:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1008:             CRTC_ADDRESS_PORT_COLOR, 0x9);
        !          1009:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1010:             CRTC_DATA_PORT_COLOR,
        !          1011:             (UCHAR)(FontInformation->HeightInPixels - 1));
        !          1012: 
        !          1013:     //
        !          1014:     // Set Width of font.
        !          1015:     //
        !          1016: 
        !          1017:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1018:             CRTC_ADDRESS_PORT_COLOR, 0x12);
        !          1019:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1020:             CRTC_DATA_PORT_COLOR,
        !          1021:             (UCHAR)(((USHORT)FontInformation->HeightInPixels *
        !          1022:             (USHORT)HwDeviceExtension->CurrentMode->row) - 1));
        !          1023: 
        !          1024:     i = HwDeviceExtension->CurrentMode->vres /
        !          1025:         HwDeviceExtension->CurrentMode->row;
        !          1026: 
        !          1027:     //
        !          1028:     // Set Cursor End
        !          1029:     //
        !          1030: 
        !          1031:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1032:             CRTC_ADDRESS_PORT_COLOR, 0xb);
        !          1033:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1034:             CRTC_DATA_PORT_COLOR, (UCHAR)--i);
        !          1035: 
        !          1036:     //
        !          1037:     // Set Cursor Statr
        !          1038:     //
        !          1039: 
        !          1040:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1041:             CRTC_ADDRESS_PORT_COLOR, 0xa);
        !          1042:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1043:             CRTC_DATA_PORT_COLOR, (UCHAR)--i);
        !          1044: 
        !          1045:     return NO_ERROR;
        !          1046: 
        !          1047: } //end VgaLoadAndSetFont()
        !          1048: 
        !          1049: VP_STATUS
        !          1050: VgaQueryCursorPosition(
        !          1051:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !          1052:     PVIDEO_CURSOR_POSITION CursorPosition,
        !          1053:     ULONG CursorPositionSize,
        !          1054:     PULONG OutputSize
        !          1055:     )
        !          1056: 
        !          1057: /*++
        !          1058: 
        !          1059: Routine Description:
        !          1060: 
        !          1061:     This routine returns the row and column of the cursor.
        !          1062: 
        !          1063: Arguments:
        !          1064: 
        !          1065:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          1066: 
        !          1067:     CursorPosition - Pointer to the output buffer supplied by the user. This
        !          1068:         is where the cursor position is stored.
        !          1069: 
        !          1070:     CursorPositionSize - Length of the output buffer supplied by the user.
        !          1071: 
        !          1072:     OutputSize - Pointer to a buffer in which to return the actual size of
        !          1073:         the data in the buffer. If the buffer was not large enough, this
        !          1074:         contains the minimum required buffer size.
        !          1075: 
        !          1076: Return Value:
        !          1077: 
        !          1078:     NO_ERROR - information returned successfully
        !          1079: 
        !          1080:     ERROR_INSUFFICIENT_BUFFER - output buffer not large enough to return
        !          1081:         any useful data
        !          1082: 
        !          1083:     ERROR_INVALID_PARAMETER - invalid video mode
        !          1084: 
        !          1085: --*/
        !          1086: 
        !          1087: {
        !          1088:     //
        !          1089:     // Text mode only; If we are in a graphics mode, return an error
        !          1090:     //
        !          1091: 
        !          1092:     if (HwDeviceExtension->CurrentMode->fbType & VIDEO_MODE_GRAPHICS) {
        !          1093: 
        !          1094:         *OutputSize = 0;
        !          1095:         return ERROR_INVALID_PARAMETER;
        !          1096: 
        !          1097:     }
        !          1098: 
        !          1099:     //
        !          1100:     // If the buffer passed in is not large enough return an
        !          1101:     // appropriate error code.
        !          1102:     //
        !          1103: 
        !          1104:     if (CursorPositionSize < (*OutputSize = sizeof(VIDEO_CURSOR_POSITION)) ) {
        !          1105: 
        !          1106:         *OutputSize = 0;
        !          1107:         return ERROR_INSUFFICIENT_BUFFER;
        !          1108: 
        !          1109:     }
        !          1110: 
        !          1111:     //
        !          1112:     // Store the postition of the cursor into the buffer.
        !          1113:     //
        !          1114: 
        !          1115:     CursorPosition->Column = HwDeviceExtension->CursorPosition.Column;
        !          1116:     CursorPosition->Row = HwDeviceExtension->CursorPosition.Row;
        !          1117: 
        !          1118:     return NO_ERROR;
        !          1119: 
        !          1120: } // end VgaQueryCursorPosition()
        !          1121: 
        !          1122: VP_STATUS
        !          1123: VgaSetCursorPosition(
        !          1124:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !          1125:     PVIDEO_CURSOR_POSITION CursorPosition,
        !          1126:     ULONG CursorPositionSize
        !          1127:     )
        !          1128: 
        !          1129: /*++
        !          1130: 
        !          1131: Routine Description:
        !          1132: 
        !          1133:     This routine verifies that the requested cursor position is within
        !          1134:     the row and column bounds of the current mode and font. If valid, then
        !          1135:     it sets the row and column of the cursor.
        !          1136: 
        !          1137: Arguments:
        !          1138: 
        !          1139:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          1140: 
        !          1141:     CursorPosition - Pointer to the structure containing the cursor position.
        !          1142: 
        !          1143:     CursorPositionSize - Length of the input buffer supplied by the user.
        !          1144: 
        !          1145: Return Value:
        !          1146: 
        !          1147:     NO_ERROR - information returned successfully
        !          1148: 
        !          1149:     ERROR_INSUFFICIENT_BUFFER - input buffer not large enough for input data
        !          1150: 
        !          1151:     ERROR_INVALID_PARAMETER - invalid video mode
        !          1152: 
        !          1153: --*/
        !          1154: 
        !          1155: {
        !          1156:     USHORT position;
        !          1157: 
        !          1158:     //
        !          1159:     // Text mode only; If we are in a graphics mode, return an error
        !          1160:     //
        !          1161: 
        !          1162:     if (HwDeviceExtension->CurrentMode->fbType & VIDEO_MODE_GRAPHICS) {
        !          1163: 
        !          1164:         return ERROR_INVALID_PARAMETER;
        !          1165: 
        !          1166:     }
        !          1167: 
        !          1168:     //
        !          1169:     // Check if the size of the data in the input buffer is large enough.
        !          1170:     //
        !          1171: 
        !          1172:     if (CursorPositionSize < sizeof(VIDEO_CURSOR_POSITION)) {
        !          1173: 
        !          1174:             return ERROR_INSUFFICIENT_BUFFER;
        !          1175: 
        !          1176:     }
        !          1177: 
        !          1178:     //
        !          1179:     // Check if the new values for the cursor positions are in the valid
        !          1180:     // bounds for the screen.
        !          1181:     //
        !          1182: 
        !          1183:     if ((CursorPosition->Column >= HwDeviceExtension->CurrentMode->col) ||
        !          1184:         (CursorPosition->Row >= HwDeviceExtension->CurrentMode->row)) {
        !          1185: 
        !          1186:         return ERROR_INVALID_PARAMETER;
        !          1187: 
        !          1188:     }
        !          1189: 
        !          1190:     //
        !          1191:     // Store these new values in the device extension so we can use them in
        !          1192:     // a QUERY.
        !          1193:     //
        !          1194: 
        !          1195:     HwDeviceExtension->CursorPosition.Column = CursorPosition->Column;
        !          1196:     HwDeviceExtension->CursorPosition.Row = CursorPosition->Row;
        !          1197: 
        !          1198:     //
        !          1199:     // Calculate the position on the screen at which the cursor must be
        !          1200:     // be displayed
        !          1201:     //
        !          1202: 
        !          1203:     position = (USHORT) (HwDeviceExtension->CurrentMode->col *
        !          1204:                          CursorPosition->Row + CursorPosition->Column);
        !          1205: 
        !          1206: 
        !          1207:     //
        !          1208:     // Address Cursor Location Low Register in CRT Controller Registers
        !          1209:     //
        !          1210: 
        !          1211:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1212:             CRTC_ADDRESS_PORT_COLOR, IND_CURSOR_LOW_LOC);
        !          1213: 
        !          1214:     //
        !          1215:     // Set Cursor Location Low Register
        !          1216:     //
        !          1217: 
        !          1218:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1219:             CRTC_DATA_PORT_COLOR, (UCHAR) (position & 0x00FF));
        !          1220: 
        !          1221:     //
        !          1222:     // Address Cursor Location High Register in CRT Controller Registers
        !          1223:     //
        !          1224: 
        !          1225:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1226:             CRTC_ADDRESS_PORT_COLOR, IND_CURSOR_HIGH_LOC);
        !          1227: 
        !          1228:     //
        !          1229:     // Set Cursor Location High Register
        !          1230:     //
        !          1231: 
        !          1232:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1233:             CRTC_DATA_PORT_COLOR, (UCHAR) (position >> 8));
        !          1234: 
        !          1235:     return NO_ERROR;
        !          1236: 
        !          1237: } // end VgaSetCursorPosition()
        !          1238: 
        !          1239: VP_STATUS
        !          1240: VgaQueryCursorAttributes(
        !          1241:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !          1242:     PVIDEO_CURSOR_ATTRIBUTES CursorAttributes,
        !          1243:     ULONG CursorAttributesSize,
        !          1244:     PULONG OutputSize
        !          1245:     )
        !          1246: 
        !          1247: /*++
        !          1248: 
        !          1249: Routine Description:
        !          1250: 
        !          1251:     This routine returns information about the height and visibility of the
        !          1252:     cursor.
        !          1253: 
        !          1254: Arguments:
        !          1255: 
        !          1256:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          1257: 
        !          1258:     CursorAttributes - Pointer to the output buffer supplied by the user.
        !          1259:         This is where the cursor type is stored.
        !          1260: 
        !          1261:     CursorAttributesSize - Length of the output buffer supplied by the user.
        !          1262: 
        !          1263:     OutputSize - Pointer to a buffer in which to return the actual size of
        !          1264:         the data in the buffer. If the buffer was not large enough, this
        !          1265:         contains the minimum required buffer size.
        !          1266: 
        !          1267: Return Value:
        !          1268: 
        !          1269:     NO_ERROR - information returned successfully
        !          1270: 
        !          1271:     ERROR_INSUFFICIENT_BUFFER - output buffer not large enough to return
        !          1272:         any useful data
        !          1273: 
        !          1274:     ERROR_INVALID_PARAMETER - invalid video mode
        !          1275: 
        !          1276: --*/
        !          1277: 
        !          1278: {
        !          1279:     //
        !          1280:     // Text mode only; If we are in a graphics mode, return an error
        !          1281:     //
        !          1282: 
        !          1283:     if (HwDeviceExtension->CurrentMode->fbType & VIDEO_MODE_GRAPHICS) {
        !          1284: 
        !          1285:         *OutputSize = 0;
        !          1286:         return ERROR_INVALID_PARAMETER;
        !          1287: 
        !          1288:     }
        !          1289: 
        !          1290:     //
        !          1291:     // Find out the size of the data to be put in the the buffer and return
        !          1292:     // that in the status information (whether or not the information is
        !          1293:     // there). If the buffer passed in is not large enough return an
        !          1294:     // appropriate error code.
        !          1295:     //
        !          1296: 
        !          1297:     if (CursorAttributesSize < (*OutputSize =
        !          1298:             sizeof(VIDEO_CURSOR_ATTRIBUTES)) ) {
        !          1299: 
        !          1300:         *OutputSize = 0;
        !          1301:         return ERROR_INSUFFICIENT_BUFFER;
        !          1302: 
        !          1303:     }
        !          1304: 
        !          1305:     //
        !          1306:     // Store the cursor information into the buffer.
        !          1307:     //
        !          1308: 
        !          1309:     CursorAttributes->Height = (USHORT) HwDeviceExtension->CursorTopScanLine;
        !          1310:     CursorAttributes->Width = (USHORT) HwDeviceExtension->CursorBottomScanLine;
        !          1311:     CursorAttributes->Enable = HwDeviceExtension->CursorEnable;
        !          1312: 
        !          1313:     return NO_ERROR;
        !          1314: 
        !          1315: } // end VgaQueryCursorAttributes()
        !          1316: 
        !          1317: VP_STATUS
        !          1318: VgaSetCursorAttributes(
        !          1319:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !          1320:     PVIDEO_CURSOR_ATTRIBUTES CursorAttributes,
        !          1321:     ULONG CursorAttributesSize
        !          1322:     )
        !          1323: 
        !          1324: /*++
        !          1325: 
        !          1326: Routine Description:
        !          1327: 
        !          1328:     This routine verifies that the requested cursor height is within the
        !          1329:     bounds of the character cell. If valid, then it sets the new
        !          1330:     visibility and height of the cursor.
        !          1331: 
        !          1332: Arguments:
        !          1333: 
        !          1334:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          1335: 
        !          1336:     CursorType - Pointer to the structure containing the cursor information.
        !          1337: 
        !          1338:     CursorTypeSize - Length of the input buffer supplied by the user.
        !          1339: 
        !          1340: Return Value:
        !          1341: 
        !          1342:     NO_ERROR - information returned successfully
        !          1343: 
        !          1344:     ERROR_INSUFFICIENT_BUFFER - input buffer not large enough for input data
        !          1345: 
        !          1346:     ERROR_INVALID_PARAMETER - invalid video mode
        !          1347: 
        !          1348: --*/
        !          1349: 
        !          1350: {
        !          1351:     UCHAR cursorLine;
        !          1352: 
        !          1353:     //
        !          1354:     // Text mode only; If we are in a graphics mode, return an error
        !          1355:     //
        !          1356: 
        !          1357:     if (HwDeviceExtension->CurrentMode->fbType & VIDEO_MODE_GRAPHICS) {
        !          1358: 
        !          1359:         return ERROR_INVALID_PARAMETER;
        !          1360: 
        !          1361:     }
        !          1362: 
        !          1363:     //
        !          1364:     // Check if the size of the data in the input buffer is large enough.
        !          1365:     //
        !          1366: 
        !          1367:     if (CursorAttributesSize < sizeof(VIDEO_CURSOR_ATTRIBUTES)) {
        !          1368: 
        !          1369:             return ERROR_INSUFFICIENT_BUFFER;
        !          1370: 
        !          1371:     }
        !          1372: 
        !          1373:     //
        !          1374:     // Check if the new values for the cursor type are in the valid range.
        !          1375:     //
        !          1376: 
        !          1377:     if ((CursorAttributes->Height >= HwDeviceExtension->FontPelRows) ||
        !          1378:         (CursorAttributes->Width > 31)) {
        !          1379: 
        !          1380:         return ERROR_INVALID_PARAMETER;
        !          1381: 
        !          1382:     }
        !          1383: 
        !          1384:     //
        !          1385:     // Store the cursor information in the device extension so we can use
        !          1386:     // them in a QUERY.
        !          1387:     //
        !          1388: 
        !          1389:     HwDeviceExtension->CursorTopScanLine = (UCHAR) CursorAttributes->Height;
        !          1390:     HwDeviceExtension->CursorBottomScanLine = (UCHAR) CursorAttributes->Width;
        !          1391:     HwDeviceExtension->CursorEnable = CursorAttributes->Enable;
        !          1392: 
        !          1393:     //
        !          1394:     // Address Cursor Start Register in CRT Controller Registers
        !          1395:     //
        !          1396: 
        !          1397:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1398:                                 CRTC_ADDRESS_PORT_COLOR,
        !          1399:                             IND_CURSOR_START);
        !          1400: 
        !          1401:     //
        !          1402:     // Set Cursor Start Register by writting to CRTCtl Data Register
        !          1403:     // Preserve the high three bits of this register.
        !          1404:     //
        !          1405:     // Only the Five low bits are used for the cursor height.
        !          1406:     // Bit 5 is cursor enable, bit 6 and 7 preserved.
        !          1407:     //
        !          1408: 
        !          1409:     cursorLine = (UCHAR) CursorAttributes->Height & 0x1F;
        !          1410: 
        !          1411:     cursorLine |= VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1412:         CRTC_DATA_PORT_COLOR) & 0xC0;
        !          1413: 
        !          1414:     if (!CursorAttributes->Enable) {
        !          1415: 
        !          1416:         cursorLine |= 0x20; // Flip cursor off bit
        !          1417: 
        !          1418:     }
        !          1419: 
        !          1420:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress + CRTC_DATA_PORT_COLOR,
        !          1421:                                 cursorLine);
        !          1422: 
        !          1423:     //
        !          1424:     // Address Cursor End Register in CRT Controller Registers
        !          1425:     //
        !          1426: 
        !          1427:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1428:                                 CRTC_ADDRESS_PORT_COLOR,
        !          1429:                             IND_CURSOR_END);
        !          1430: 
        !          1431:     //
        !          1432:     // Set Cursor End Register. Preserve the high three bits of this
        !          1433:     // register.
        !          1434:     //
        !          1435: 
        !          1436:     cursorLine =
        !          1437:         (CursorAttributes->Width < (USHORT)(HwDeviceExtension->FontPelRows - 1)) ?
        !          1438:         CursorAttributes->Width : (HwDeviceExtension->FontPelRows - 1);
        !          1439: 
        !          1440:     cursorLine &= 0x1f;
        !          1441: 
        !          1442:     cursorLine |= VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1443:             CRTC_DATA_PORT_COLOR) & 0xE0;
        !          1444: 
        !          1445:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress + CRTC_DATA_PORT_COLOR,
        !          1446:                             cursorLine);
        !          1447: 
        !          1448:     return NO_ERROR;
        !          1449: 
        !          1450: } // end VgaSetCursorAttributes()
        !          1451: 
        !          1452: BOOLEAN
        !          1453: VgaIsPresent(
        !          1454:     PHW_DEVICE_EXTENSION HwDeviceExtension
        !          1455:     )
        !          1456: 
        !          1457: /*++
        !          1458: 
        !          1459: Routine Description:
        !          1460: 
        !          1461:     This routine returns TRUE if a VGA is present. Determining whether a VGA
        !          1462:     is present is a two-step process. First, this routine walks bits through
        !          1463:     the Bit Mask register, to establish that there are readable indexed
        !          1464:     registers (EGAs normally don't have readable registers, and other adapters
        !          1465:     are unlikely to have indexed registers). This test is done first because
        !          1466:     it's a non-destructive EGA rejection test (correctly rejects EGAs, but
        !          1467:     doesn't potentially mess up the screen or the accessibility of display
        !          1468:     memory). Normally, this would be an adequate test, but some EGAs have
        !          1469:     readable registers, so next, we check for the existence of the Chain4 bit
        !          1470:     in the Memory Mode register; this bit doesn't exist in EGAs. It's
        !          1471:     conceivable that there are EGAs with readable registers and a register bit
        !          1472:     where Chain4 is stored, although I don't know of any; if a better test yet
        !          1473:     is needed, memory could be written to in Chain4 mode, and then examined
        !          1474:     plane by plane in non-Chain4 mode to make sure the Chain4 bit did what it's
        !          1475:     supposed to do. However, the current test should be adequate to eliminate
        !          1476:     just about all EGAs, and 100% of everything else.
        !          1477: 
        !          1478:     If this function fails to find a VGA, it attempts to undo any damage it
        !          1479:     may have inadvertently done while testing. The underlying assumption for
        !          1480:     the damage control is that if there's any non-VGA adapter at the tested
        !          1481:     ports, it's an EGA or an enhanced EGA, because: a) I don't know of any
        !          1482:     other adapters that use 3C4/5 or 3CE/F, and b), if there are other
        !          1483:     adapters, I certainly don't know how to restore their original states. So
        !          1484:     all error recovery is oriented toward putting an EGA back in a writable
        !          1485:     state, so that error messages are visible. The EGA's state on entry is
        !          1486:     assumed to be text mode, so the Memory Mode register is restored to the
        !          1487:     default state for text mode.
        !          1488: 
        !          1489:     If a VGA is found, the VGA is returned to its original state after
        !          1490:     testing is finished.
        !          1491: 
        !          1492: Arguments:
        !          1493: 
        !          1494:     None.
        !          1495: 
        !          1496: Return Value:
        !          1497: 
        !          1498:     TRUE if a VGA is present, FALSE if not.
        !          1499: 
        !          1500: --*/
        !          1501: 
        !          1502: {
        !          1503:     UCHAR originalGCAddr;
        !          1504:     UCHAR originalSCAddr;
        !          1505:     UCHAR originalBitMask;
        !          1506:     UCHAR originalReadMap;
        !          1507:     UCHAR originalMemoryMode;
        !          1508:     UCHAR testMask;
        !          1509:     BOOLEAN returnStatus;
        !          1510: 
        !          1511:     //
        !          1512:     // Remember the original state of the Graphics Controller Address register.
        !          1513:     //
        !          1514: 
        !          1515:     originalGCAddr = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1516:             GRAPH_ADDRESS_PORT);
        !          1517: 
        !          1518:     //
        !          1519:     // Write the Read Map register with a known state so we can verify
        !          1520:     // that it isn't changed after we fool with the Bit Mask. This ensures
        !          1521:     // that we're dealing with indexed registers, since both the Read Map and
        !          1522:     // the Bit Mask are addressed at GRAPH_DATA_PORT.
        !          1523:     //
        !          1524: 
        !          1525:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1526:             GRAPH_ADDRESS_PORT, IND_READ_MAP);
        !          1527: 
        !          1528:     //
        !          1529:     // If we can't read back the Graphics Address register setting we just
        !          1530:     // performed, it's not readable and this isn't a VGA.
        !          1531:     //
        !          1532: 
        !          1533:     if ((VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1534:         GRAPH_ADDRESS_PORT) & GRAPH_ADDR_MASK) != IND_READ_MAP) {
        !          1535: 
        !          1536:         return FALSE;
        !          1537:     }
        !          1538: 
        !          1539:     //
        !          1540:     // Set the Read Map register to a known state.
        !          1541:     //
        !          1542: 
        !          1543:     originalReadMap = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1544:             GRAPH_DATA_PORT);
        !          1545:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1546:             GRAPH_DATA_PORT, READ_MAP_TEST_SETTING);
        !          1547: 
        !          1548:     if (VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1549:             GRAPH_DATA_PORT) != READ_MAP_TEST_SETTING) {
        !          1550: 
        !          1551:         //
        !          1552:         // The Read Map setting we just performed can't be read back; not a
        !          1553:         // VGA. Restore the default Read Map state.
        !          1554:         //
        !          1555: 
        !          1556:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1557:                 GRAPH_DATA_PORT, READ_MAP_DEFAULT);
        !          1558: 
        !          1559:         return FALSE;
        !          1560:     }
        !          1561: 
        !          1562:     //
        !          1563:     // Remember the original setting of the Bit Mask register.
        !          1564:     //
        !          1565: 
        !          1566:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1567:             GRAPH_ADDRESS_PORT, IND_BIT_MASK);
        !          1568:     if ((VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1569:                 GRAPH_ADDRESS_PORT) & GRAPH_ADDR_MASK) != IND_BIT_MASK) {
        !          1570: 
        !          1571:         //
        !          1572:         // The Graphics Address register setting we just made can't be read
        !          1573:         // back; not a VGA. Restore the default Read Map state.
        !          1574:         //
        !          1575: 
        !          1576:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1577:                 GRAPH_ADDRESS_PORT, IND_READ_MAP);
        !          1578:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1579:                 GRAPH_DATA_PORT, READ_MAP_DEFAULT);
        !          1580: 
        !          1581:         return FALSE;
        !          1582:     }
        !          1583: 
        !          1584:     originalBitMask = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1585:             GRAPH_DATA_PORT);
        !          1586: 
        !          1587:     //
        !          1588:     // Set up the initial test mask we'll write to and read from the Bit Mask.
        !          1589:     //
        !          1590: 
        !          1591:     testMask = 0xBB;
        !          1592: 
        !          1593:     do {
        !          1594: 
        !          1595:         //
        !          1596:         // Write the test mask to the Bit Mask.
        !          1597:         //
        !          1598: 
        !          1599:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1600:                 GRAPH_DATA_PORT, testMask);
        !          1601: 
        !          1602:         //
        !          1603:         // Make sure the Bit Mask remembered the value.
        !          1604:         //
        !          1605: 
        !          1606:         if (VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1607:                     GRAPH_DATA_PORT) != testMask) {
        !          1608: 
        !          1609:             //
        !          1610:             // The Bit Mask is not properly writable and readable; not a VGA.
        !          1611:             // Restore the Bit Mask and Read Map to their default states.
        !          1612:             //
        !          1613: 
        !          1614:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1615:                     GRAPH_DATA_PORT, BIT_MASK_DEFAULT);
        !          1616:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1617:                     GRAPH_ADDRESS_PORT, IND_READ_MAP);
        !          1618:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1619:                     GRAPH_DATA_PORT, READ_MAP_DEFAULT);
        !          1620: 
        !          1621:             return FALSE;
        !          1622:         }
        !          1623: 
        !          1624:         //
        !          1625:         // Cycle the mask for next time.
        !          1626:         //
        !          1627: 
        !          1628:         testMask >>= 1;
        !          1629: 
        !          1630:     } while (testMask != 0);
        !          1631: 
        !          1632:     //
        !          1633:     // There's something readable at GRAPH_DATA_PORT; now switch back and
        !          1634:     // make sure that the Read Map register hasn't changed, to verify that
        !          1635:     // we're dealing with indexed registers.
        !          1636:     //
        !          1637: 
        !          1638:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1639:             GRAPH_ADDRESS_PORT, IND_READ_MAP);
        !          1640:     if (VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1641:                 GRAPH_DATA_PORT) != READ_MAP_TEST_SETTING) {
        !          1642: 
        !          1643:         //
        !          1644:         // The Read Map is not properly writable and readable; not a VGA.
        !          1645:         // Restore the Bit Mask and Read Map to their default states, in case
        !          1646:         // this is an EGA, so subsequent writes to the screen aren't garbled.
        !          1647:         //
        !          1648: 
        !          1649:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1650:                 GRAPH_DATA_PORT, READ_MAP_DEFAULT);
        !          1651:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1652:                 GRAPH_ADDRESS_PORT, IND_BIT_MASK);
        !          1653:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1654:                 GRAPH_DATA_PORT, BIT_MASK_DEFAULT);
        !          1655: 
        !          1656:         return FALSE;
        !          1657:     }
        !          1658: 
        !          1659:     //
        !          1660:     // We've pretty surely verified the existence of the Bit Mask register.
        !          1661:     // Put the Graphics Controller back to the original state.
        !          1662:     //
        !          1663: 
        !          1664:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1665:             GRAPH_DATA_PORT, originalReadMap);
        !          1666:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1667:             GRAPH_ADDRESS_PORT, IND_BIT_MASK);
        !          1668:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1669:             GRAPH_DATA_PORT, originalBitMask);
        !          1670:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1671:             GRAPH_ADDRESS_PORT, originalGCAddr);
        !          1672: 
        !          1673:     //
        !          1674:     // Now, check for the existence of the Chain4 bit.
        !          1675:     //
        !          1676: 
        !          1677:     //
        !          1678:     // Remember the original states of the Sequencer Address and Memory Mode
        !          1679:     // registers.
        !          1680:     //
        !          1681: 
        !          1682:     originalSCAddr = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1683:             SEQ_ADDRESS_PORT);
        !          1684:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1685:             SEQ_ADDRESS_PORT, IND_MEMORY_MODE);
        !          1686:     if ((VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1687:             SEQ_ADDRESS_PORT) & SEQ_ADDR_MASK) != IND_MEMORY_MODE) {
        !          1688: 
        !          1689:         //
        !          1690:         // Couldn't read back the Sequencer Address register setting we just
        !          1691:         // performed.
        !          1692:         //
        !          1693: 
        !          1694:         return FALSE;
        !          1695:     }
        !          1696:     originalMemoryMode = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1697:             SEQ_DATA_PORT);
        !          1698: 
        !          1699:     //
        !          1700:     // Toggle the Chain4 bit and read back the result. This must be done during
        !          1701:     // sync reset, since we're changing the chaining state.
        !          1702:     //
        !          1703: 
        !          1704:     //
        !          1705:     // Begin sync reset.
        !          1706:     //
        !          1707: 
        !          1708:     VideoPortWritePortUshort((PUSHORT)(HwDeviceExtension->IOAddress +
        !          1709:              SEQ_ADDRESS_PORT),
        !          1710:              (IND_SYNC_RESET + (START_SYNC_RESET_VALUE << 8)));
        !          1711: 
        !          1712:     //
        !          1713:     // Toggle the Chain4 bit.
        !          1714:     //
        !          1715: 
        !          1716:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1717:             SEQ_ADDRESS_PORT, IND_MEMORY_MODE);
        !          1718:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1719:             SEQ_DATA_PORT, (UCHAR)(originalMemoryMode ^ CHAIN4_MASK));
        !          1720: 
        !          1721:     if (VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1722:                 SEQ_DATA_PORT) != (UCHAR) (originalMemoryMode ^ CHAIN4_MASK)) {
        !          1723: 
        !          1724:         //
        !          1725:         // Chain4 bit not there; not a VGA.
        !          1726:         // Set text mode default for Memory Mode register.
        !          1727:         //
        !          1728: 
        !          1729:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1730:                 SEQ_DATA_PORT, MEMORY_MODE_TEXT_DEFAULT);
        !          1731:         //
        !          1732:         // End sync reset.
        !          1733:         //
        !          1734: 
        !          1735:         VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          1736:                 SEQ_ADDRESS_PORT),
        !          1737:                 (IND_SYNC_RESET + (END_SYNC_RESET_VALUE << 8)));
        !          1738: 
        !          1739:         returnStatus = FALSE;
        !          1740: 
        !          1741:     } else {
        !          1742: 
        !          1743:         //
        !          1744:         // It's a VGA.
        !          1745:         //
        !          1746: 
        !          1747:         //
        !          1748:         // Restore the original Memory Mode setting.
        !          1749:         //
        !          1750: 
        !          1751:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1752:                 SEQ_DATA_PORT, originalMemoryMode);
        !          1753: 
        !          1754:         //
        !          1755:         // End sync reset.
        !          1756:         //
        !          1757: 
        !          1758:         VideoPortWritePortUshort((PUSHORT)(HwDeviceExtension->IOAddress +
        !          1759:                 SEQ_ADDRESS_PORT),
        !          1760:                 (USHORT)(IND_SYNC_RESET + (END_SYNC_RESET_VALUE << 8)));
        !          1761: 
        !          1762:         //
        !          1763:         // Restore the original Sequencer Address setting.
        !          1764:         //
        !          1765: 
        !          1766:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1767:                 SEQ_ADDRESS_PORT, originalSCAddr);
        !          1768: 
        !          1769:         returnStatus = TRUE;
        !          1770:     }
        !          1771: 
        !          1772:     return returnStatus;
        !          1773: 
        !          1774: } // VgaIsPresent()
        !          1775: 
        !          1776: BOOLEAN
        !          1777: WdIsPresent(
        !          1778:     PHW_DEVICE_EXTENSION HwDeviceExtension
        !          1779:     )
        !          1780: 
        !          1781: /*++
        !          1782: 
        !          1783: Routine Description:
        !          1784: 
        !          1785:     This routine returns TRUE if an WDVGA is present. It assumes that it's
        !          1786:     already been established that a VGA is present.  It performs the Western
        !          1787:     Digital recommended ID test.  If all this works, then this is indeed an
        !          1788:     chip from Western Digital.
        !          1789: 
        !          1790:     All the registers will be preserved either this function fails to find a
        !          1791:     WD vga or a WD vga is found.
        !          1792: 
        !          1793: Arguments:
        !          1794: 
        !          1795:     None.
        !          1796: 
        !          1797: Return Value:
        !          1798: 
        !          1799:     TRUE if a WDVGA is present, FALSE if not.
        !          1800: 
        !          1801: --*/
        !          1802: 
        !          1803: {
        !          1804:     #define MAX_ROM_SCAN 4096
        !          1805: 
        !          1806:     UCHAR   *pRomAddr;
        !          1807:     PHYSICAL_ADDRESS paRom = {0x000C0000,0x00000000};
        !          1808: 
        !          1809:     UCHAR GraphSave0c;
        !          1810:     UCHAR GraphSave0f;
        !          1811:     UCHAR temp1, temp2;
        !          1812: 
        !          1813:     BOOLEAN status = TRUE;
        !          1814: 
        !          1815:     //
        !          1816:     // write 3ce.0c
        !          1817:     //
        !          1818: 
        !          1819:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1820:             GRAPH_ADDRESS_PORT, 0x0c);
        !          1821:     GraphSave0c = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1822:             GRAPH_DATA_PORT);
        !          1823:     temp1 = GraphSave0c & 0xbf;
        !          1824:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1825:             GRAPH_DATA_PORT, temp1);
        !          1826: 
        !          1827:     //
        !          1828:     // write 3ce.0f
        !          1829:     //
        !          1830: 
        !          1831:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1832:             GRAPH_ADDRESS_PORT, 0x0f);
        !          1833:     GraphSave0f = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1834:             GRAPH_DATA_PORT);
        !          1835:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1836:             GRAPH_DATA_PORT, 0x0);
        !          1837: 
        !          1838:     //
        !          1839:     // write 3ce.09
        !          1840:     //
        !          1841: 
        !          1842:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1843:             GRAPH_ADDRESS_PORT, 0x09);
        !          1844:     temp1 = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1845:             GRAPH_DATA_PORT);
        !          1846:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1847:             GRAPH_DATA_PORT, (UCHAR)(temp1+1));
        !          1848:     temp2 = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1849:             GRAPH_DATA_PORT);
        !          1850:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1851:             GRAPH_DATA_PORT, temp1);
        !          1852: 
        !          1853:     if ((temp1+1) == temp2) {
        !          1854: 
        !          1855:         status = FALSE;
        !          1856:         goto NOT_WDVGA;
        !          1857: 
        !          1858:     }
        !          1859: 
        !          1860:     VideoPortWritePortUshort((PUSHORT)(HwDeviceExtension->IOAddress +
        !          1861:             GRAPH_ADDRESS_PORT), 0x050f);
        !          1862:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1863:             GRAPH_ADDRESS_PORT, 0x09);
        !          1864:     temp1 = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1865:             GRAPH_DATA_PORT);
        !          1866:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1867:             GRAPH_DATA_PORT, (UCHAR)(temp1+1));
        !          1868:     temp2 = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1869:             GRAPH_DATA_PORT);
        !          1870:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1871:             GRAPH_DATA_PORT, temp1);
        !          1872: 
        !          1873:     if ((temp1+1) != temp2) {
        !          1874: 
        !          1875:         status = FALSE;
        !          1876:         goto NOT_WDVGA;
        !          1877: 
        !          1878:     }
        !          1879: 
        !          1880:     //
        !          1881:     // it *is* a WDVGA!
        !          1882:     //
        !          1883: 
        !          1884:     //
        !          1885:     // Look for extended regsiters that are only in WD90C31 and over
        !          1886:     //
        !          1887: 
        !          1888:     if (HwDeviceExtension->ExtendedRegisters) {
        !          1889: 
        !          1890:         UCHAR save;
        !          1891:         PUCHAR ExtendedIOAddress;
        !          1892: 
        !          1893:         //
        !          1894:         // Assume we have a WD90C31
        !          1895:         //
        !          1896: 
        !          1897:         HwDeviceExtension->BoardID = WD90C31;
        !          1898: 
        !          1899:         //
        !          1900:         // Get WDC31 extended port base address.
        !          1901:         //
        !          1902: 
        !          1903:         if ((ExtendedIOAddress =
        !          1904:              VideoPortGetDeviceBase(HwDeviceExtension,
        !          1905:                                     VgaAccessRange[3].RangeStart,
        !          1906:                                     VgaAccessRange[3].RangeLength,
        !          1907:                                     VgaAccessRange[3].RangeInIoSpace)) == NULL) {
        !          1908: 
        !          1909:             VideoDebugPrint((2, "WDVGAIsPresent - Fail to get ext. io address\n"));
        !          1910:             status = FALSE;
        !          1911:             goto NOT_WDVGA;
        !          1912: 
        !          1913:         }
        !          1914: 
        !          1915:         save = VideoPortReadPortUchar(ExtendedIOAddress);
        !          1916:                
        !          1917:         VideoPortWritePortUchar(ExtendedIOAddress, 0x02);
        !          1918: 
        !          1919:         temp1 = VideoPortReadPortUchar(ExtendedIOAddress);
        !          1920: 
        !          1921:         if (temp1 != 0x02) {
        !          1922: 
        !          1923:             //
        !          1924:             // WD90C30 or older.
        !          1925:             //
        !          1926: 
        !          1927:             HwDeviceExtension->BoardID = WD90C30;
        !          1928: 
        !          1929:             //
        !          1930:             // If, after looking at the chip, there is no extended registers,
        !          1931:             // then undeclare their use.
        !          1932:             //
        !          1933: 
        !          1934:             VideoPortVerifyAccessRanges(HwDeviceExtension,
        !          1935:                                         NUM_VGA_ACCESS_RANGES,
        !          1936:                                         VgaAccessRange);
        !          1937: 
        !          1938:             HwDeviceExtension->ExtendedRegisters = FALSE;
        !          1939: 
        !          1940:         }
        !          1941: 
        !          1942:         VideoPortWritePortUchar(ExtendedIOAddress, save);
        !          1943: 
        !          1944:         VideoPortFreeDeviceBase(HwDeviceExtension,
        !          1945:                                 ExtendedIOAddress);
        !          1946: 
        !          1947:     } else {
        !          1948: 
        !          1949:         //
        !          1950:         // Assume a 90c30 if we could not claim the extended registers.
        !          1951:         //
        !          1952: 
        !          1953:         HwDeviceExtension->BoardID = WD90C30;
        !          1954: 
        !          1955:     }
        !          1956: 
        !          1957:     //
        !          1958:     // Get chip type to determine if we have a 90c30 or 90c00
        !          1959:     //
        !          1960: 
        !          1961:     if (HwDeviceExtension->BoardID < WD90C31) {
        !          1962: 
        !          1963:         UCHAR SeqSave08;
        !          1964: 
        !          1965:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1966:                 SEQ_ADDRESS_PORT, 0x06);
        !          1967:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1968:                 SEQ_DATA_PORT, 0x48);
        !          1969: 
        !          1970:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1971:                 SEQ_ADDRESS_PORT, 0x08);
        !          1972:         SeqSave08 = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1973:                 SEQ_DATA_PORT);
        !          1974: 
        !          1975:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1976:                 SEQ_DATA_PORT, 0x5A);
        !          1977:         temp1 = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          1978:                 SEQ_DATA_PORT);
        !          1979: 
        !          1980:         if ( temp1 != 0x5A ) {
        !          1981: 
        !          1982:             //
        !          1983:             // old chip, can't support 1R1W banking
        !          1984:             //
        !          1985: 
        !          1986:             HwDeviceExtension->BoardID = WD90C00;
        !          1987: 
        !          1988:         }
        !          1989: 
        !          1990:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1991:                 SEQ_ADDRESS_PORT, 0x08);
        !          1992:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          1993:                 SEQ_DATA_PORT, SeqSave08);
        !          1994: 
        !          1995:     }
        !          1996: 
        !          1997:     //
        !          1998:     // Detect a Speestart 90c31 board.
        !          1999:     //
        !          2000:     // Map in the ROM address space at 0xc000:0
        !          2001:     //
        !          2002: 
        !          2003:     pRomAddr = VideoPortGetDeviceBase(HwDeviceExtension,
        !          2004:                                       paRom,
        !          2005:                                       (ULONG)0x00008000,
        !          2006:                                       FALSE);
        !          2007: 
        !          2008:     if (pRomAddr) {       // Valid ROM address?
        !          2009: 
        !          2010:         //
        !          2011:         // Look for brand name signatures (from DIAMOND) in the ROM.
        !          2012:         //
        !          2013: 
        !          2014:         //
        !          2015:         // We will try to recognize a few boards.
        !          2016:         // make sure we are looking at a bios!
        !          2017:         //
        !          2018: 
        !          2019:         if (*((PUSHORT) pRomAddr) == 0xAA55) {
        !          2020: 
        !          2021:             if (VideoPortScanRom(HwDeviceExtension,
        !          2022:                                  pRomAddr,
        !          2023:                                  MAX_ROM_SCAN,
        !          2024:                                  "  SpeedStar 24X")) {
        !          2025: 
        !          2026:                 if (HwDeviceExtension->BoardID == WD90C31) {
        !          2027: 
        !          2028:                     HwDeviceExtension->BoardID = SPEEDSTAR31;
        !          2029: 
        !          2030: 
        !          2031:                 } else if (HwDeviceExtension->BoardID == WD90C30) {
        !          2032: 
        !          2033:                     HwDeviceExtension->BoardID = SPEEDSTAR30;
        !          2034: 
        !          2035:                 }
        !          2036:             }
        !          2037:         }
        !          2038: 
        !          2039:         VideoPortFreeDeviceBase(HwDeviceExtension,
        !          2040:                                 pRomAddr);
        !          2041: 
        !          2042:     }
        !          2043: 
        !          2044:     //
        !          2045:     // Get the memory size.
        !          2046:     //
        !          2047: 
        !          2048:     VgaSizeMemory(HwDeviceExtension);
        !          2049: 
        !          2050:     //
        !          2051:     // Finally, just validate the list of modes.
        !          2052:     //
        !          2053: 
        !          2054:     VgaValidateModes(HwDeviceExtension);
        !          2055: 
        !          2056: 
        !          2057: NOT_WDVGA:
        !          2058: 
        !          2059:     //
        !          2060:     // Restore registers to what they were.
        !          2061:     //
        !          2062: 
        !          2063:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2064:             GRAPH_ADDRESS_PORT, 0x0c);
        !          2065:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2066:             GRAPH_DATA_PORT, GraphSave0c);
        !          2067: 
        !          2068:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2069:             GRAPH_ADDRESS_PORT, 0x0f);
        !          2070:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2071:             GRAPH_DATA_PORT, GraphSave0f);
        !          2072: 
        !          2073: 
        !          2074:     return status;
        !          2075: 
        !          2076: } // end WdIsPresent()
        !          2077: 
        !          2078: 
        !          2079: VOID
        !          2080: VgaSizeMemory(
        !          2081:     PHW_DEVICE_EXTENSION HwDeviceExtension
        !          2082:     )
        !          2083: 
        !          2084: /*++
        !          2085: 
        !          2086: Routine Description:
        !          2087: 
        !          2088:     This routine determines the amount of VideoMemory on the adapter.
        !          2089: 
        !          2090: Arguments:
        !          2091: 
        !          2092:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          2093: 
        !          2094: Return Value:
        !          2095: 
        !          2096:     None.
        !          2097: 
        !          2098: --*/
        !          2099: {
        !          2100: 
        !          2101:     UCHAR data;
        !          2102: 
        !          2103:     //
        !          2104:     // 3CF.B Memory size
        !          2105:     //
        !          2106: 
        !          2107:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2108:             GRAPH_ADDRESS_PORT, 0x0B);
        !          2109: 
        !          2110:     data = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          2111:             GRAPH_DATA_PORT);
        !          2112:         
        !          2113:     switch ( data & 0xC0 ) {
        !          2114: 
        !          2115:     case 0x00:
        !          2116:     case 0x40:
        !          2117: 
        !          2118:         HwDeviceExtension->AdapterMemorySize = 0x00040000;
        !          2119:         break;
        !          2120: 
        !          2121:     case 0x80:
        !          2122: 
        !          2123:         HwDeviceExtension->AdapterMemorySize = 0x00080000;
        !          2124:         break;
        !          2125: 
        !          2126:     case 0xC0:
        !          2127: 
        !          2128:         HwDeviceExtension->AdapterMemorySize = 0x00100000;
        !          2129:         break;
        !          2130: 
        !          2131:     default:
        !          2132:         break;
        !          2133: 
        !          2134:     }
        !          2135: } // end VgaSizeMemory();
        !          2136: 
        !          2137: 
        !          2138: VP_STATUS
        !          2139: VgaSetPaletteReg(
        !          2140:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !          2141:     PVIDEO_PALETTE_DATA PaletteBuffer,
        !          2142:     ULONG PaletteBufferSize
        !          2143:     )
        !          2144: 
        !          2145: /*++
        !          2146: 
        !          2147: Routine Description:
        !          2148: 
        !          2149:     This routine sets a specified portion of the EGA (not DAC) palette
        !          2150:     registers.
        !          2151: 
        !          2152: Arguments:
        !          2153: 
        !          2154:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          2155: 
        !          2156:     PaletteBuffer - Pointer to the structure containing the palette data.
        !          2157: 
        !          2158:     PaletteBufferSize - Length of the input buffer supplied by the user.
        !          2159: 
        !          2160: Return Value:
        !          2161: 
        !          2162:     NO_ERROR - information returned successfully
        !          2163: 
        !          2164:     ERROR_INSUFFICIENT_BUFFER - input buffer not large enough for input data.
        !          2165: 
        !          2166:     ERROR_INVALID_PARAMETER - invalid palette size.
        !          2167: 
        !          2168: --*/
        !          2169: 
        !          2170: {
        !          2171:     USHORT i;
        !          2172: 
        !          2173:     //
        !          2174:     // Check if the size of the data in the input buffer is large enough.
        !          2175:     //
        !          2176: 
        !          2177:     if ((PaletteBufferSize) < (sizeof(VIDEO_PALETTE_DATA)) ||
        !          2178:         (PaletteBufferSize < (sizeof(VIDEO_PALETTE_DATA) +
        !          2179:                 (sizeof(USHORT) * (PaletteBuffer->NumEntries -1)) ))) {
        !          2180: 
        !          2181:         return ERROR_INSUFFICIENT_BUFFER;
        !          2182: 
        !          2183:     }
        !          2184: 
        !          2185:     //
        !          2186:     // Check to see if the parameters are valid.
        !          2187:     //
        !          2188: 
        !          2189:     if ( (PaletteBuffer->FirstEntry > VIDEO_MAX_COLOR_REGISTER ) ||
        !          2190:          (PaletteBuffer->NumEntries == 0) ||
        !          2191:          (PaletteBuffer->FirstEntry + PaletteBuffer->NumEntries >
        !          2192:              VIDEO_MAX_PALETTE_REGISTER + 1 ) ) {
        !          2193: 
        !          2194:         return ERROR_INVALID_PARAMETER;
        !          2195: 
        !          2196:     }
        !          2197: 
        !          2198:     //
        !          2199:     // Reset ATC to index mode
        !          2200:     //
        !          2201: 
        !          2202:     VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          2203:                            ATT_INITIALIZE_PORT_COLOR);
        !          2204: 
        !          2205:     //
        !          2206:     // Blast out our palette values.
        !          2207:     //
        !          2208: 
        !          2209:     for (i = 0; i < PaletteBuffer->NumEntries; i++) {
        !          2210: 
        !          2211:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress + ATT_ADDRESS_PORT,
        !          2212:                                 (UCHAR)(i+PaletteBuffer->FirstEntry));
        !          2213: 
        !          2214:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2215:                                     ATT_DATA_WRITE_PORT,
        !          2216:                                 (UCHAR)PaletteBuffer->Colors[i]);
        !          2217:     }
        !          2218: 
        !          2219:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress + ATT_ADDRESS_PORT,
        !          2220:                             VIDEO_ENABLE);
        !          2221: 
        !          2222: 
        !          2223:     return NO_ERROR;
        !          2224: 
        !          2225: } // end VgaSetPaletteReg()
        !          2226: 
        !          2227: 
        !          2228: VP_STATUS
        !          2229: VgaSetColorLookup(
        !          2230:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !          2231:     PVIDEO_CLUT ClutBuffer,
        !          2232:     ULONG ClutBufferSize
        !          2233:     )
        !          2234: 
        !          2235: /*++
        !          2236: 
        !          2237: Routine Description:
        !          2238: 
        !          2239:     This routine sets a specified portion of the DAC color lookup table
        !          2240:     settings.
        !          2241: 
        !          2242: Arguments:
        !          2243: 
        !          2244:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          2245: 
        !          2246:     ClutBufferSize - Length of the input buffer supplied by the user.
        !          2247: 
        !          2248:     ClutBuffer - Pointer to the structure containing the color lookup table.
        !          2249: 
        !          2250: Return Value:
        !          2251: 
        !          2252:     NO_ERROR - information returned successfully
        !          2253: 
        !          2254:     ERROR_INSUFFICIENT_BUFFER - input buffer not large enough for input data.
        !          2255: 
        !          2256:     ERROR_INVALID_PARAMETER - invalid clut size.
        !          2257: 
        !          2258: --*/
        !          2259: 
        !          2260: {
        !          2261:     ULONG i;
        !          2262: 
        !          2263:     //
        !          2264:     // Check if the size of the data in the input buffer is large enough.
        !          2265:     //
        !          2266: 
        !          2267:     if ( (ClutBufferSize < sizeof(VIDEO_CLUT) - sizeof(ULONG)) ||
        !          2268:          (ClutBufferSize < sizeof(VIDEO_CLUT) +
        !          2269:                      (sizeof(ULONG) * (ClutBuffer->NumEntries - 1)) ) ) {
        !          2270: 
        !          2271:         return ERROR_INSUFFICIENT_BUFFER;
        !          2272: 
        !          2273:     }
        !          2274: 
        !          2275:     //
        !          2276:     // Check to see if the parameters are valid.
        !          2277:     //
        !          2278: 
        !          2279:     if ( (ClutBuffer->NumEntries == 0) ||
        !          2280:          (ClutBuffer->FirstEntry > VIDEO_MAX_COLOR_REGISTER) ||
        !          2281:          (ClutBuffer->FirstEntry + ClutBuffer->NumEntries >
        !          2282:                                      VIDEO_MAX_COLOR_REGISTER + 1) ) {
        !          2283: 
        !          2284:         return ERROR_INVALID_PARAMETER;
        !          2285: 
        !          2286:     }
        !          2287: 
        !          2288:     //
        !          2289:     //  Set CLUT registers directly on the hardware
        !          2290:     //
        !          2291: 
        !          2292:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2293:             DAC_ADDRESS_WRITE_PORT, (UCHAR) ClutBuffer->FirstEntry);
        !          2294: 
        !          2295:     for (i = 0; i < ClutBuffer->NumEntries; i++) {
        !          2296: 
        !          2297:         VideoPortWritePortBufferUchar((PUCHAR)HwDeviceExtension->IOAddress +
        !          2298:                                           DAC_DATA_REG_PORT,
        !          2299:                                       &(ClutBuffer->LookupTable[i].RgbArray.Red),
        !          2300:                                           0x03);
        !          2301: 
        !          2302:     }
        !          2303: 
        !          2304:     return NO_ERROR;
        !          2305: 
        !          2306: } // end VgaSetColorLookup()
        !          2307: 
        !          2308: VP_STATUS
        !          2309: VgaRestoreHardwareState(
        !          2310:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !          2311:     PVIDEO_HARDWARE_STATE HardwareState,
        !          2312:     ULONG HardwareStateSize
        !          2313:     )
        !          2314: 
        !          2315: /*++
        !          2316: 
        !          2317: Routine Description:
        !          2318: 
        !          2319:     Restores all registers and memory of the VGA.
        !          2320: 
        !          2321:     Note: HardwareState points to the actual buffer from which the state
        !          2322:     is to be restored. This buffer will always be big enough (we specified
        !          2323:     the required size at DriverEntry).
        !          2324: 
        !          2325:     Note: The offset in the hardware state header from which each general
        !          2326:     register is restored is the offset of the write address of that register
        !          2327:     from the base I/O address of the VGA.
        !          2328: 
        !          2329: 
        !          2330:     !!! NOTE
        !          2331:     We assume the miniport and the display driver have UNLOCKED the extended
        !          2332:     registers so we can READ and WRITE them.
        !          2333: 
        !          2334: Arguments:
        !          2335: 
        !          2336:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          2337: 
        !          2338:     HardwareState - Pointer to a structure from which the saved state is to be
        !          2339:         restored (actually only info about and a pointer to the actual save
        !          2340:         buffer).
        !          2341: 
        !          2342:     HardwareStateSize - Length of the input buffer supplied by the user.
        !          2343:         (Actually only the size of the HardwareState structure, not the
        !          2344:         buffer it points to from which the state is actually restored. The
        !          2345:         pointed-to buffer is assumed to be big enough.)
        !          2346: 
        !          2347: Return Value:
        !          2348: 
        !          2349:     NO_ERROR - restore performed successfully
        !          2350: 
        !          2351:     ERROR_INSUFFICIENT_BUFFER - input buffer not large enough to provide data
        !          2352: 
        !          2353: --*/
        !          2354: 
        !          2355: {
        !          2356:     PVIDEO_HARDWARE_STATE_HEADER hardwareStateHeader;
        !          2357:     ULONG i;
        !          2358:     UCHAR dummy;
        !          2359:     PUCHAR pScreen;
        !          2360:     PUCHAR pucLatch;
        !          2361:     PULONG pulBuffer;
        !          2362:     PUCHAR port;
        !          2363:     PUCHAR portValue;
        !          2364:     PUCHAR portValueDAC;
        !          2365:     ULONG bIsColor;
        !          2366: 
        !          2367: 
        !          2368:     //
        !          2369:     // Check if the size of the data in the input buffer is large enough.
        !          2370:     //
        !          2371: 
        !          2372:     if ((HardwareStateSize < sizeof(VIDEO_HARDWARE_STATE)) ||
        !          2373:             (HardwareState->StateLength < VGA_TOTAL_STATE_SIZE)) {
        !          2374: 
        !          2375:             return ERROR_INSUFFICIENT_BUFFER;
        !          2376: 
        !          2377:     }
        !          2378: 
        !          2379:     //
        !          2380:     // Point to the buffer where the restore data is actually stored.
        !          2381:     //
        !          2382: 
        !          2383:     hardwareStateHeader = HardwareState->StateHeader;
        !          2384: 
        !          2385:     //
        !          2386:     // Make sure the offset are in the structure ...
        !          2387:     //
        !          2388: 
        !          2389:     if ((hardwareStateHeader->BasicSequencerOffset + VGA_NUM_SEQUENCER_PORTS >
        !          2390:             HardwareState->StateLength) ||
        !          2391: 
        !          2392:         (hardwareStateHeader->BasicCrtContOffset + VGA_NUM_CRTC_PORTS >
        !          2393:             HardwareState->StateLength) ||
        !          2394: 
        !          2395:         (hardwareStateHeader->BasicGraphContOffset + VGA_NUM_GRAPH_CONT_PORTS >
        !          2396:             HardwareState->StateLength) ||
        !          2397: 
        !          2398:         (hardwareStateHeader->BasicAttribContOffset + VGA_NUM_ATTRIB_CONT_PORTS >
        !          2399:             HardwareState->StateLength) ||
        !          2400: 
        !          2401:         (hardwareStateHeader->BasicDacOffset + (3 * VGA_NUM_DAC_ENTRIES) >
        !          2402:             HardwareState->StateLength) ||
        !          2403: 
        !          2404:         (hardwareStateHeader->BasicLatchesOffset + 4 >
        !          2405:             HardwareState->StateLength) ||
        !          2406: 
        !          2407:         (hardwareStateHeader->ExtendedSequencerOffset + EXT_NUM_SEQUENCER_PORTS >
        !          2408:             HardwareState->StateLength) ||
        !          2409: 
        !          2410:         (hardwareStateHeader->ExtendedCrtContOffset + EXT_NUM_CRTC_PORTS >
        !          2411:             HardwareState->StateLength) ||
        !          2412: 
        !          2413:         (hardwareStateHeader->ExtendedGraphContOffset + EXT_NUM_GRAPH_CONT_PORTS >
        !          2414:             HardwareState->StateLength) ||
        !          2415: 
        !          2416:         (hardwareStateHeader->ExtendedAttribContOffset + EXT_NUM_ATTRIB_CONT_PORTS >
        !          2417:             HardwareState->StateLength) ||
        !          2418: 
        !          2419:         (hardwareStateHeader->ExtendedDacOffset + (4 * EXT_NUM_DAC_ENTRIES) >
        !          2420:             HardwareState->StateLength) ||
        !          2421: 
        !          2422:         //
        !          2423:         // Only check the validator state offset if there is unemulated data.
        !          2424:         //
        !          2425: 
        !          2426:         ((hardwareStateHeader->VGAStateFlags & VIDEO_STATE_UNEMULATED_VGA_STATE) &&
        !          2427:             (hardwareStateHeader->ExtendedValidatorStateOffset + VGA_VALIDATOR_AREA_SIZE >
        !          2428:             HardwareState->StateLength)) ||
        !          2429: 
        !          2430:         (hardwareStateHeader->ExtendedMiscDataOffset + VGA_MISC_DATA_AREA_OFFSET >
        !          2431:             HardwareState->StateLength) ||
        !          2432: 
        !          2433:         (hardwareStateHeader->Plane1Offset + hardwareStateHeader->PlaneLength >
        !          2434:             HardwareState->StateLength) ||
        !          2435: 
        !          2436:         (hardwareStateHeader->Plane2Offset + hardwareStateHeader->PlaneLength >
        !          2437:             HardwareState->StateLength) ||
        !          2438: 
        !          2439:         (hardwareStateHeader->Plane3Offset + hardwareStateHeader->PlaneLength >
        !          2440:             HardwareState->StateLength) ||
        !          2441: 
        !          2442:         (hardwareStateHeader->Plane4Offset + hardwareStateHeader->PlaneLength >
        !          2443:             HardwareState->StateLength) ||
        !          2444: 
        !          2445:         (hardwareStateHeader->DIBOffset +
        !          2446:             hardwareStateHeader->DIBBitsPerPixel / 8 *
        !          2447:             hardwareStateHeader->DIBXResolution *
        !          2448:             hardwareStateHeader->DIBYResolution  > HardwareState->StateLength) ||
        !          2449: 
        !          2450:         (hardwareStateHeader->DIBXlatOffset + hardwareStateHeader->DIBXlatLength >
        !          2451:             HardwareState->StateLength)) {
        !          2452: 
        !          2453:         return ERROR_INVALID_PARAMETER;
        !          2454: 
        !          2455:     }
        !          2456: 
        !          2457:     //
        !          2458:     // Set DAC register 0 to display black.
        !          2459:     //
        !          2460: 
        !          2461:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2462:             DAC_ADDRESS_WRITE_PORT, 0);
        !          2463:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2464:             DAC_DATA_REG_PORT, 0);
        !          2465:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2466:             DAC_DATA_REG_PORT, 0);
        !          2467:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2468:             DAC_DATA_REG_PORT, 0);
        !          2469: 
        !          2470:     //
        !          2471:     // Set the DAC mask register to force DAC register 0 to display all the
        !          2472:     // time (this is the register we just set to display black). From now on,
        !          2473:     // nothing but black will show up on the screen.
        !          2474:     //
        !          2475: 
        !          2476:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2477:             DAC_PIXEL_MASK_PORT, 0);
        !          2478: 
        !          2479: 
        !          2480:     //
        !          2481:     // Restore the latches and the contents of display memory.
        !          2482:     //
        !          2483:     // Set up the VGA's hardware to allow us to copy to each plane in turn.
        !          2484:     //
        !          2485:     // Begin sync reset.
        !          2486:     //
        !          2487: 
        !          2488:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2489:             SEQ_ADDRESS_PORT),
        !          2490:             (USHORT) (IND_SYNC_RESET + (START_SYNC_RESET_VALUE << 8)));
        !          2491: 
        !          2492:     //
        !          2493:     // Turn off Chain mode and map display memory at A0000 for 64K.
        !          2494:     //
        !          2495: 
        !          2496:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2497:             GRAPH_ADDRESS_PORT, IND_GRAPH_MISC);
        !          2498:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2499:             GRAPH_DATA_PORT, (UCHAR) ((VideoPortReadPortUchar(
        !          2500:             HwDeviceExtension->IOAddress + GRAPH_DATA_PORT) & 0xF1) | 0x04));
        !          2501: 
        !          2502:     //
        !          2503:     // Turn off Chain4 mode and odd/even.
        !          2504:     //
        !          2505: 
        !          2506:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2507:             SEQ_ADDRESS_PORT, IND_MEMORY_MODE);
        !          2508:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2509:             SEQ_DATA_PORT,
        !          2510:             (UCHAR) ((VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          2511:             SEQ_DATA_PORT) & 0xF3) | 0x04));
        !          2512: 
        !          2513:     //
        !          2514:     // End sync reset.
        !          2515:     //
        !          2516: 
        !          2517:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2518:             SEQ_ADDRESS_PORT), (USHORT) (IND_SYNC_RESET +
        !          2519:             (END_SYNC_RESET_VALUE << 8)));
        !          2520: 
        !          2521:     //
        !          2522:     // Set the write mode to 0, the read mode to 0, and turn off odd/even.
        !          2523:     //
        !          2524: 
        !          2525:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2526:             GRAPH_ADDRESS_PORT, IND_GRAPH_MODE);
        !          2527:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2528:             GRAPH_DATA_PORT,
        !          2529:             (UCHAR) ((VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          2530:             GRAPH_DATA_PORT) & 0xE4) | 0x00));
        !          2531: 
        !          2532:     //
        !          2533:     // Set the Bit Mask to 0xFF to allow all CPU bits through.
        !          2534:     //
        !          2535: 
        !          2536:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2537:             GRAPH_ADDRESS_PORT), (USHORT) (IND_BIT_MASK + (0xFF << 8)));
        !          2538: 
        !          2539:     //
        !          2540:     // Set the Data Rotation and Logical Function fields to 0 to allow CPU
        !          2541:     // data through unmodified.
        !          2542:     //
        !          2543: 
        !          2544:     VideoPortWritePortUshort((PUSHORT)(HwDeviceExtension->IOAddress +
        !          2545:             GRAPH_ADDRESS_PORT), (USHORT) (IND_DATA_ROTATE + (0 << 8)));
        !          2546: 
        !          2547:     //
        !          2548:     // Set Set/Reset Enable to 0 to select CPU data for all planes.
        !          2549:     //
        !          2550: 
        !          2551:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2552:             GRAPH_ADDRESS_PORT), (USHORT) (IND_SET_RESET_ENABLE + (0 << 8)));
        !          2553: 
        !          2554:     //
        !          2555:     // Point the Sequencer Index to the Map Mask register.
        !          2556:     //
        !          2557: 
        !          2558:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2559:              SEQ_ADDRESS_PORT, IND_MAP_MASK);
        !          2560: 
        !          2561:     //
        !          2562:     // Restore the latches.
        !          2563:     //
        !          2564:     // Point to the saved data for the first latch.
        !          2565:     //
        !          2566: 
        !          2567:     pucLatch = ((PUCHAR) (hardwareStateHeader)) +
        !          2568:             hardwareStateHeader->BasicLatchesOffset;
        !          2569: 
        !          2570:     //
        !          2571:     // Point to first byte of display memory.
        !          2572:     //
        !          2573: 
        !          2574:     pScreen = (PUCHAR) HwDeviceExtension->VideoMemoryAddress;
        !          2575: 
        !          2576:     //
        !          2577:     // Write the contents to be restored to each of the four latches in turn.
        !          2578:     //
        !          2579: 
        !          2580:     for (i = 0; i < 4; i++) {
        !          2581: 
        !          2582:         //
        !          2583:         // Set the Map Mask to select the plane we want to restore next.
        !          2584:         //
        !          2585: 
        !          2586:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2587:                 SEQ_DATA_PORT, (UCHAR)(1<<i));
        !          2588: 
        !          2589:         //
        !          2590:         // Write this plane's latch.
        !          2591:         //
        !          2592: 
        !          2593:         VideoPortWriteRegisterUchar(pScreen, *pucLatch++);
        !          2594: 
        !          2595:     }
        !          2596: 
        !          2597:     //
        !          2598:     // Read the latched data into the latches, and the latches are set.
        !          2599:     //
        !          2600: 
        !          2601:     dummy = VideoPortReadRegisterUchar(pScreen);
        !          2602: 
        !          2603: 
        !          2604:     //
        !          2605:     // Point to the offset of the saved data for the first plane.
        !          2606:     //
        !          2607: 
        !          2608:     pulBuffer = &(hardwareStateHeader->Plane1Offset);
        !          2609: 
        !          2610:     //
        !          2611:     // Restore each of the four planes in turn.
        !          2612:     //
        !          2613: 
        !          2614:     for (i = 0; i < 4; i++) {
        !          2615: 
        !          2616:         //
        !          2617:         // Set the Map Mask to select the plane we want to restore next.
        !          2618:         //
        !          2619: 
        !          2620:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2621:                 SEQ_DATA_PORT, (UCHAR)(1<<i));
        !          2622: 
        !          2623:         //
        !          2624:         // Restore this plane from the buffer.
        !          2625:         //
        !          2626: 
        !          2627:         VideoPortMoveMemory((PUCHAR) HwDeviceExtension->VideoMemoryAddress,
        !          2628:                            ((PUCHAR) (hardwareStateHeader)) + *pulBuffer,
        !          2629:                            hardwareStateHeader->PlaneLength);
        !          2630: 
        !          2631:         pulBuffer++;
        !          2632: 
        !          2633:     }
        !          2634: 
        !          2635:     //
        !          2636:     // If we have some unemulated data, put it back into the buffer
        !          2637:     //
        !          2638: 
        !          2639:     if (hardwareStateHeader->VGAStateFlags & VIDEO_STATE_UNEMULATED_VGA_STATE) {
        !          2640: 
        !          2641:         if (!hardwareStateHeader->ExtendedValidatorStateOffset) {
        !          2642: 
        !          2643:             return ERROR_INVALID_PARAMETER;
        !          2644: 
        !          2645:         }
        !          2646: 
        !          2647:         //
        !          2648:         // Get the right offset in the struct and save all the data associated
        !          2649:         // with the trapped validator data.
        !          2650:         //
        !          2651: 
        !          2652:         VideoPortMoveMemory(&(HwDeviceExtension->TrappedValidatorCount),
        !          2653:                             ((PUCHAR) (hardwareStateHeader)) +
        !          2654:                                 hardwareStateHeader->ExtendedValidatorStateOffset,
        !          2655:                             VGA_VALIDATOR_AREA_SIZE);
        !          2656: 
        !          2657:         //
        !          2658:         // Check to see if this is an appropriate access range.
        !          2659:         // We are trapping - so we must have the trapping access range enabled.
        !          2660:         //
        !          2661: 
        !          2662:         if (((HwDeviceExtension->CurrentVdmAccessRange != FullVgaValidatorAccessRange) ||
        !          2663:              (HwDeviceExtension->CurrentNumVdmAccessRanges != NUM_FULL_VGA_VALIDATOR_ACCESS_RANGE)) &&
        !          2664:             ((HwDeviceExtension->CurrentVdmAccessRange != MinimalVgaValidatorAccessRange) ||
        !          2665:              (HwDeviceExtension->CurrentNumVdmAccessRanges != NUM_MINIMAL_VGA_VALIDATOR_ACCESS_RANGE))) {
        !          2666: 
        !          2667:             return ERROR_INVALID_PARAMETER;
        !          2668: 
        !          2669:         }
        !          2670: 
        !          2671:         VideoPortSetTrappedEmulatorPorts(HwDeviceExtension,
        !          2672:                                          HwDeviceExtension->CurrentNumVdmAccessRanges,
        !          2673:                                          HwDeviceExtension->CurrentVdmAccessRange);
        !          2674: 
        !          2675:     }
        !          2676: 
        !          2677:     //
        !          2678:     // Set the critical registers (clock and timing states) during sync reset.
        !          2679:     //
        !          2680:     // Begin sync reset.
        !          2681:     //
        !          2682: 
        !          2683:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2684:             SEQ_ADDRESS_PORT), (USHORT) (IND_SYNC_RESET +
        !          2685:             (START_SYNC_RESET_VALUE << 8)));
        !          2686: 
        !          2687:     //
        !          2688:     // Restore the Miscellaneous Output register.
        !          2689:     //
        !          2690: 
        !          2691:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2692:             MISC_OUTPUT_REG_WRITE_PORT,
        !          2693:             (UCHAR) (hardwareStateHeader->PortValue[MISC_OUTPUT_REG_WRITE_PORT] & 0xF7));
        !          2694: 
        !          2695:     //
        !          2696:     // Restore all Sequencer registers except the Sync Reset register, which
        !          2697:     // is always not in reset (except when we send out a batched sync reset
        !          2698:     // register set, but that can't be interrupted, so we know we're never in
        !          2699:     // sync reset at save/restore time).
        !          2700:     //
        !          2701: 
        !          2702:     portValue = ((PUCHAR) hardwareStateHeader) +
        !          2703:             hardwareStateHeader->BasicSequencerOffset + 1;
        !          2704: 
        !          2705:     for (i = 1; i < VGA_NUM_SEQUENCER_PORTS; i++) {
        !          2706: 
        !          2707:         VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2708:                 SEQ_ADDRESS_PORT), (USHORT) (i + ((*portValue++) << 8)) );
        !          2709: 
        !          2710:     }
        !          2711: 
        !          2712:     //
        !          2713:     // Restore extended sequencer registers
        !          2714:     //
        !          2715: 
        !          2716: #ifdef EXTENDED_REGISTER_SAVE_RESTORE
        !          2717: 
        !          2718:     if (hardwareStateHeader->ExtendedSequencerOffset) {
        !          2719: 
        !          2720:         portValue = ((PUCHAR) hardwareStateHeader) +
        !          2721:                           hardwareStateHeader->ExtendedSequencerOffset;
        !          2722: 
        !          2723:         for (i = WD_SEQUENCER_EXT_START; i <= WD_SEQUENCER_EXT_END; i++) {
        !          2724: 
        !          2725:             VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2726:                                          SEQ_ADDRESS_PORT),
        !          2727:                                      (USHORT) (i + ((*portValue++) << 8)) );
        !          2728: 
        !          2729:         }
        !          2730: 
        !          2731:         //
        !          2732:         // Restore the second set of sequencer registers.
        !          2733:         //
        !          2734: 
        !          2735:         for (i = WD_SEQUENCER_1_EXT_START; i <= WD_SEQUENCER_1_EXT_END; i++) {
        !          2736: 
        !          2737:             VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2738:                                          SEQ_ADDRESS_PORT),
        !          2739:                                      (USHORT) (i + ((*portValue++) << 8)) );
        !          2740: 
        !          2741:         }
        !          2742:     }
        !          2743: 
        !          2744: #endif
        !          2745: 
        !          2746:     //
        !          2747:     // Restore the Graphics Controller Miscellaneous register, which contains
        !          2748:     // the Chain bit.
        !          2749:     //
        !          2750: 
        !          2751:     portValue = ((PUCHAR) hardwareStateHeader) +
        !          2752:                 hardwareStateHeader->BasicGraphContOffset + IND_GRAPH_MISC;
        !          2753: 
        !          2754:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2755:             GRAPH_ADDRESS_PORT), (USHORT)(IND_GRAPH_MISC + (*portValue << 8)));
        !          2756: 
        !          2757:     //
        !          2758:     // End sync reset.
        !          2759:     //
        !          2760: 
        !          2761:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2762:             SEQ_ADDRESS_PORT), (USHORT) (IND_SYNC_RESET +
        !          2763:             (END_SYNC_RESET_VALUE << 8)));
        !          2764: 
        !          2765:     //
        !          2766:     // Figure out if color/mono switchable registers are at 3BX or 3DX.
        !          2767:     // At the same time, save the state of the Miscellaneous Output register
        !          2768:     // which is read from 3CC but written at 3C2.
        !          2769:     //
        !          2770: 
        !          2771:     if (hardwareStateHeader->PortValue[MISC_OUTPUT_REG_WRITE_PORT] & 0x01) {
        !          2772:         bIsColor = TRUE;
        !          2773:     } else {
        !          2774:         bIsColor = FALSE;
        !          2775:     }
        !          2776: 
        !          2777: 
        !          2778:     //
        !          2779:     // Restore the CRT Controller indexed registers.
        !          2780:     //
        !          2781:     // Unlock CRTC registers 0-7.
        !          2782:     //
        !          2783: 
        !          2784:     portValue = (PUCHAR) hardwareStateHeader +
        !          2785:             hardwareStateHeader->BasicCrtContOffset;
        !          2786: 
        !          2787:     if (bIsColor) {
        !          2788: 
        !          2789:         VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2790:                 CRTC_ADDRESS_PORT_COLOR), (USHORT) (IND_CRTC_PROTECT +
        !          2791:                 (((*(portValue + IND_CRTC_PROTECT)) & 0x7F) << 8)));
        !          2792: 
        !          2793:     } else {
        !          2794: 
        !          2795:         VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2796:                 CRTC_ADDRESS_PORT_MONO), (USHORT) (IND_CRTC_PROTECT +
        !          2797:                 (((*(portValue + IND_CRTC_PROTECT)) & 0x7F) << 8)));
        !          2798: 
        !          2799:     }
        !          2800: 
        !          2801: 
        !          2802: 
        !          2803:     //
        !          2804:     // Restore extended crtc registers.
        !          2805:     //
        !          2806: 
        !          2807: #ifdef EXTENDED_REGISTER_SAVE_RESTORE
        !          2808: 
        !          2809:     if (hardwareStateHeader->ExtendedCrtContOffset) {
        !          2810: 
        !          2811:         portValue = (PUCHAR) hardwareStateHeader +
        !          2812:                          hardwareStateHeader->ExtendedCrtContOffset;
        !          2813: 
        !          2814:         for (i = WD_CRTC_EXT_START; i <= WD_CRTC_EXT_END; i++) {
        !          2815: 
        !          2816:             if (bIsColor) {
        !          2817: 
        !          2818:                 VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2819:                                              CRTC_ADDRESS_PORT_COLOR),
        !          2820:                                          (USHORT) (i + ((*portValue++) << 8)));
        !          2821: 
        !          2822:             } else {
        !          2823: 
        !          2824:                 VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2825:                                              CRTC_ADDRESS_PORT_MONO),
        !          2826:                                          (USHORT) (i + ((*portValue++) << 8)));
        !          2827: 
        !          2828:             }
        !          2829:         }
        !          2830: 
        !          2831:         //
        !          2832:         // Second set of crtc registers
        !          2833:         //
        !          2834: 
        !          2835:         for (i = WD_CRTC_1_EXT_START; i <= WD_CRTC_1_EXT_END; i++) {
        !          2836: 
        !          2837:             if (bIsColor) {
        !          2838: 
        !          2839:                 VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2840:                                              CRTC_ADDRESS_PORT_COLOR),
        !          2841:                                          (USHORT) (i + ((*portValue++) << 8)));
        !          2842: 
        !          2843:             } else {
        !          2844: 
        !          2845:                 VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2846:                                              CRTC_ADDRESS_PORT_MONO),
        !          2847:                                          (USHORT) (i + ((*portValue++) << 8)));
        !          2848: 
        !          2849:             }
        !          2850:         }
        !          2851:     }
        !          2852: 
        !          2853: #endif
        !          2854: 
        !          2855:     //
        !          2856:     // Now restore the CRTC registers.
        !          2857:     //
        !          2858: 
        !          2859:     portValue = (PUCHAR) hardwareStateHeader +
        !          2860:             hardwareStateHeader->BasicCrtContOffset;
        !          2861: 
        !          2862:     for (i = 0; i < VGA_NUM_CRTC_PORTS; i++) {
        !          2863: 
        !          2864:         if (bIsColor) {
        !          2865: 
        !          2866:             VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2867:                     CRTC_ADDRESS_PORT_COLOR),
        !          2868:                     (USHORT) (i + ((*portValue++) << 8)));
        !          2869: 
        !          2870:         } else {
        !          2871: 
        !          2872:             VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2873:                     CRTC_ADDRESS_PORT_MONO),
        !          2874:                     (USHORT) (i + ((*portValue++) << 8)));
        !          2875: 
        !          2876:         }
        !          2877: 
        !          2878:     }
        !          2879: 
        !          2880: 
        !          2881:     //
        !          2882:     // Restore the Graphics Controller indexed registers.
        !          2883:     //
        !          2884: 
        !          2885:     portValue = (PUCHAR) hardwareStateHeader +
        !          2886:             hardwareStateHeader->BasicGraphContOffset;
        !          2887: 
        !          2888:     for (i = 0; i < VGA_NUM_GRAPH_CONT_PORTS; i++) {
        !          2889: 
        !          2890:         VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2891:                 GRAPH_ADDRESS_PORT), (USHORT) (i + ((*portValue++) << 8)));
        !          2892: 
        !          2893:     }
        !          2894: 
        !          2895: 
        !          2896:     //
        !          2897:     // Restore extended graphics controller registers.
        !          2898:     //
        !          2899: 
        !          2900: #ifdef EXTENDED_REGISTER_SAVE_RESTORE
        !          2901: 
        !          2902:     //
        !          2903:     // The extended lock register (index 0x0F) will be restored last, so we do
        !          2904:     // not need to do anything special with it.
        !          2905:     //
        !          2906: 
        !          2907:     if (hardwareStateHeader->ExtendedGraphContOffset) {
        !          2908: 
        !          2909:         portValue = (PUCHAR) hardwareStateHeader +
        !          2910:                              hardwareStateHeader->ExtendedGraphContOffset;
        !          2911: 
        !          2912:         for (i = WD_GRAPH_EXT_START; i <= WD_GRAPH_EXT_END; i++) {
        !          2913: 
        !          2914:             VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          2915:                                          GRAPH_ADDRESS_PORT),
        !          2916:                                      (USHORT) (i + ((*portValue++) << 8)));
        !          2917: 
        !          2918:         }
        !          2919:     }
        !          2920: 
        !          2921: #endif 
        !          2922: 
        !          2923:     //
        !          2924:     // Restore the Attribute Controller indexed registers.
        !          2925:     //
        !          2926: 
        !          2927:     portValue = (PUCHAR) hardwareStateHeader +
        !          2928:             hardwareStateHeader->BasicAttribContOffset;
        !          2929: 
        !          2930:     //
        !          2931:     // Reset the AC index/data toggle, then blast out all the register
        !          2932:     // settings.
        !          2933:     //
        !          2934: 
        !          2935:     if (bIsColor) {
        !          2936:         dummy = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          2937:                 INPUT_STATUS_1_COLOR);
        !          2938:     } else {
        !          2939:         dummy = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          2940:                 INPUT_STATUS_1_MONO);
        !          2941:     }
        !          2942: 
        !          2943:     for (i = 0; i < VGA_NUM_ATTRIB_CONT_PORTS; i++) {
        !          2944: 
        !          2945:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2946:                 ATT_ADDRESS_PORT, (UCHAR)i);
        !          2947:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2948:                 ATT_DATA_WRITE_PORT, *portValue++);
        !          2949: 
        !          2950:     }
        !          2951: 
        !          2952: 
        !          2953:     //
        !          2954:     // Restore DAC registers 1 through 255. We'll do register 0, the DAC Mask,
        !          2955:     // and the index registers later.
        !          2956:     // Set the DAC address port Index, then write out the DAC Data registers.
        !          2957:     // Each three reads get Red, Green, and Blue components for that register.
        !          2958:     //
        !          2959:     // Write them one at a time due to problems on local bus machines.
        !          2960:     //
        !          2961: 
        !          2962:     portValueDAC = (PUCHAR) hardwareStateHeader +
        !          2963:                    hardwareStateHeader->BasicDacOffset + 3;
        !          2964: 
        !          2965:     for (i = 1; i < VGA_NUM_DAC_ENTRIES; i++) {
        !          2966: 
        !          2967:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2968:                                 DAC_ADDRESS_WRITE_PORT, (UCHAR)i);
        !          2969: 
        !          2970:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2971:                                 DAC_DATA_REG_PORT, *portValueDAC++);
        !          2972: 
        !          2973:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2974:                                 DAC_DATA_REG_PORT, *portValueDAC++);
        !          2975: 
        !          2976:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2977:                                 DAC_DATA_REG_PORT, *portValueDAC++);
        !          2978: 
        !          2979:     }
        !          2980: 
        !          2981:     //
        !          2982:     // Extended registers are not CURRENTLY supported in this driver.
        !          2983:     //
        !          2984: 
        !          2985: 
        !          2986:     //
        !          2987:     // Restore the Feature Control register.
        !          2988:     //
        !          2989: 
        !          2990:     if (bIsColor) {
        !          2991: 
        !          2992:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2993:                 FEAT_CTRL_WRITE_PORT_COLOR,
        !          2994:                 hardwareStateHeader->PortValue[FEAT_CTRL_WRITE_PORT_COLOR]);
        !          2995: 
        !          2996:     } else {
        !          2997: 
        !          2998:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          2999:                 FEAT_CTRL_WRITE_PORT_MONO,
        !          3000:                 hardwareStateHeader->PortValue[FEAT_CTRL_WRITE_PORT_MONO]);
        !          3001: 
        !          3002:     }
        !          3003: 
        !          3004: 
        !          3005:     //
        !          3006:     // Restore the Sequencer Index.
        !          3007:     //
        !          3008: 
        !          3009:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3010:             SEQ_ADDRESS_PORT,
        !          3011:             hardwareStateHeader->PortValue[SEQ_ADDRESS_PORT]);
        !          3012: 
        !          3013:     //
        !          3014:     // Restore the CRT Controller Index.
        !          3015:     //
        !          3016: 
        !          3017:     if (bIsColor) {
        !          3018: 
        !          3019:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3020:                 CRTC_ADDRESS_PORT_COLOR,
        !          3021:                 hardwareStateHeader->PortValue[CRTC_ADDRESS_PORT_COLOR]);
        !          3022: 
        !          3023:     } else {
        !          3024: 
        !          3025:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3026:                 CRTC_ADDRESS_PORT_MONO,
        !          3027:                 hardwareStateHeader->PortValue[CRTC_ADDRESS_PORT_MONO]);
        !          3028: 
        !          3029:     }
        !          3030: 
        !          3031: 
        !          3032:     //
        !          3033:     // Restore the Graphics Controller Index.
        !          3034:     //
        !          3035: 
        !          3036:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3037:             GRAPH_ADDRESS_PORT,
        !          3038:             hardwareStateHeader->PortValue[GRAPH_ADDRESS_PORT]);
        !          3039: 
        !          3040: 
        !          3041:     //
        !          3042:     // Restore the Attribute Controller Index and index/data toggle state.
        !          3043:     //
        !          3044: 
        !          3045:     if (bIsColor) {
        !          3046:         port = HwDeviceExtension->IOAddress + INPUT_STATUS_1_COLOR;
        !          3047:     } else {
        !          3048:         port = HwDeviceExtension->IOAddress + INPUT_STATUS_1_MONO;
        !          3049:     }
        !          3050: 
        !          3051:     VideoPortReadPortUchar(port);  // reset the toggle to Index state
        !          3052: 
        !          3053:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3054:             ATT_ADDRESS_PORT,  // restore the AC Index
        !          3055:             hardwareStateHeader->PortValue[ATT_ADDRESS_PORT]);
        !          3056: 
        !          3057:     //
        !          3058:     // If the toggle should be in Data state, we're all set. If it should be in
        !          3059:     // Index state, reset it to that condition.
        !          3060:     //
        !          3061: 
        !          3062:     if (hardwareStateHeader->AttribIndexDataState == 0) {
        !          3063: 
        !          3064:         //
        !          3065:         // Reset the toggle to Index state.
        !          3066:         //
        !          3067: 
        !          3068:         VideoPortReadPortUchar(port);
        !          3069: 
        !          3070:     }
        !          3071: 
        !          3072: 
        !          3073:     //
        !          3074:     // Restore DAC register 0 and the DAC Mask, to unblank the screen.
        !          3075:     //
        !          3076: 
        !          3077:     portValueDAC = (PUCHAR) hardwareStateHeader +
        !          3078:             hardwareStateHeader->BasicDacOffset;
        !          3079: 
        !          3080:     //
        !          3081:     // Restore the DAC Mask register.
        !          3082:     //
        !          3083: 
        !          3084:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3085:             DAC_PIXEL_MASK_PORT,
        !          3086:             hardwareStateHeader->PortValue[DAC_PIXEL_MASK_PORT]);
        !          3087: 
        !          3088:     //
        !          3089:     // Restore DAC register 0.
        !          3090:     //
        !          3091: 
        !          3092:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3093:             DAC_ADDRESS_WRITE_PORT, 0);
        !          3094:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3095:             DAC_DATA_REG_PORT, *portValueDAC++);
        !          3096:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3097:             DAC_DATA_REG_PORT, *portValueDAC++);
        !          3098:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3099:             DAC_DATA_REG_PORT, *portValueDAC++);
        !          3100: 
        !          3101: 
        !          3102:     //
        !          3103:     // Restore the read/write state and the current index of the DAC.
        !          3104:     //
        !          3105:     // See whether the Read or Write Index was written to most recently.
        !          3106:     // (The upper nibble stored at DAC_STATE_PORT is the # of reads/writes
        !          3107:     // for the current index.)
        !          3108:     //
        !          3109: 
        !          3110:     if ((hardwareStateHeader->PortValue[DAC_STATE_PORT] & 0x0F) == 3) {
        !          3111: 
        !          3112:         //
        !          3113:         // The DAC Read Index was written to last. Restore the DAC by setting
        !          3114:         // up to read from the saved index - 1, because the way the Read
        !          3115:         // Index works is that it autoincrements after reading, so you actually
        !          3116:         // end up reading the data for the index you read at the DAC Write
        !          3117:         // Mask register - 1.
        !          3118:         //
        !          3119:         // Set the Read Index to the index we read, minus 1, accounting for
        !          3120:         // wrap from 255 back to 0. The DAC hardware immediately reads this
        !          3121:         // register into a temporary buffer, then adds 1 to the index.
        !          3122:         //
        !          3123: 
        !          3124:         if (hardwareStateHeader->PortValue[DAC_ADDRESS_WRITE_PORT] == 0) {
        !          3125: 
        !          3126:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3127:                     DAC_ADDRESS_READ_PORT, 255);
        !          3128: 
        !          3129:         } else {
        !          3130: 
        !          3131:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3132:                     DAC_ADDRESS_READ_PORT, (UCHAR)
        !          3133:                     (hardwareStateHeader->PortValue[DAC_ADDRESS_WRITE_PORT] -
        !          3134:                     1));
        !          3135: 
        !          3136:         }
        !          3137: 
        !          3138:         //
        !          3139:         // Now read the hardware however many times are required to get to
        !          3140:         // the partial read state we saved.
        !          3141:         //
        !          3142: 
        !          3143:         for (i = hardwareStateHeader->PortValue[DAC_STATE_PORT] >> 4;
        !          3144:                 i > 0; i--) {
        !          3145: 
        !          3146:             dummy = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3147:                     DAC_DATA_REG_PORT);
        !          3148: 
        !          3149:         }
        !          3150: 
        !          3151:     } else {
        !          3152: 
        !          3153:         //
        !          3154:         // The DAC Write Index was written to last. Set the Write Index to the
        !          3155:         // index value we read out of the DAC. Then, if a partial write
        !          3156:         // (partway through an RGB triplet) was in place, write the partial
        !          3157:         // values, which we obtained by writing them to the current DAC
        !          3158:         // register. This DAC register will be wrong until the write is
        !          3159:         // completed, but at least the values will be right once the write is
        !          3160:         // finished, and most importantly we won't have messed up the sequence
        !          3161:         // of RGB writes (which can be as long as 768 in a row).
        !          3162:         //
        !          3163: 
        !          3164:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3165:                 DAC_ADDRESS_WRITE_PORT,
        !          3166:                 hardwareStateHeader->PortValue[DAC_ADDRESS_WRITE_PORT]);
        !          3167: 
        !          3168:         //
        !          3169:         // Now write to the hardware however many times are required to get to
        !          3170:         // the partial write state we saved (if any).
        !          3171:         //
        !          3172:         // Point to the saved value for the DAC register that was in the
        !          3173:         // process of being written to; we wrote the partial value out, so now
        !          3174:         // we can restore it.
        !          3175:         //
        !          3176: 
        !          3177:         portValueDAC = (PUCHAR) hardwareStateHeader +
        !          3178:                 hardwareStateHeader->BasicDacOffset +
        !          3179:                 (hardwareStateHeader->PortValue[DAC_ADDRESS_WRITE_PORT] * 3);
        !          3180: 
        !          3181:         for (i = hardwareStateHeader->PortValue[DAC_STATE_PORT] >> 4;
        !          3182:                 i > 0; i--) {
        !          3183: 
        !          3184:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3185:                     DAC_DATA_REG_PORT, *portValueDAC++);
        !          3186: 
        !          3187:         }
        !          3188: 
        !          3189:     }
        !          3190: 
        !          3191:     return NO_ERROR;
        !          3192: 
        !          3193: } // end VgaRestoreHardwareState()
        !          3194: 
        !          3195: VP_STATUS
        !          3196: VgaSaveHardwareState(
        !          3197:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !          3198:     PVIDEO_HARDWARE_STATE HardwareState,
        !          3199:     ULONG HardwareStateSize,
        !          3200:     PULONG OutputSize
        !          3201:     )
        !          3202: 
        !          3203: /*++
        !          3204: 
        !          3205: Routine Description:
        !          3206: 
        !          3207:     Saves all registers and memory of the VGA.
        !          3208: 
        !          3209:     Note: HardwareState points to the actual buffer in which the state
        !          3210:     is saved. This buffer will always be big enough (we specified
        !          3211:     the required size at DriverEntry).
        !          3212: 
        !          3213:     Note: This routine leaves registers in any state it cares to, except
        !          3214:     that it will not mess with any of the CRT or Sequencer parameters that
        !          3215:     might make the monitor unhappy. It leaves the screen blanked by setting
        !          3216:     the DAC Mask and DAC register 0 to all zero values. The next video
        !          3217:     operation we expect after this is a mode set to take us back to Win32.
        !          3218: 
        !          3219:     Note: The offset in the hardware state header in which each general
        !          3220:     register is saved is the offset of the write address of that register from
        !          3221:     the base I/O address of the VGA.
        !          3222: 
        !          3223:     !!! NOTE
        !          3224:     We must force the extended registers to be unlocked.
        !          3225: 
        !          3226: Arguments:
        !          3227: 
        !          3228:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          3229: 
        !          3230:     HardwareState - Pointer to a structure in which the saved state will be
        !          3231:         returned (actually only info about and a pointer to the actual save
        !          3232:         buffer).
        !          3233: 
        !          3234:     HardwareStateSize - Length of the output buffer supplied by the user.
        !          3235:         (Actually only the size of the HardwareState structure, not the
        !          3236:         buffer it points to where the state is actually saved. The pointed-
        !          3237:         to buffer is assumed to be big enough.)
        !          3238: 
        !          3239:     OutputSize - Pointer to a buffer in which to return the actual size of
        !          3240:         the data returned in the buffer.
        !          3241: 
        !          3242: Return Value:
        !          3243: 
        !          3244:     NO_ERROR - information returned successfully
        !          3245: 
        !          3246:     ERROR_INSUFFICIENT_BUFFER - output buffer not large enough to return
        !          3247:         any useful data
        !          3248: 
        !          3249: --*/
        !          3250: 
        !          3251: {
        !          3252:     PVIDEO_HARDWARE_STATE_HEADER hardwareStateHeader;
        !          3253:     PUCHAR pScreen;
        !          3254:     PUCHAR portValue;
        !          3255:     PUCHAR portValueDAC;
        !          3256:     PUCHAR bufferPointer;
        !          3257:     ULONG i;
        !          3258:     UCHAR dummy, originalACIndex, originalACData;
        !          3259:     UCHAR ucCRTC03;
        !          3260:     ULONG bIsColor;
        !          3261: 
        !          3262: 
        !          3263:     //
        !          3264:     // See if the buffer is big enough to hold the hardware state structure.
        !          3265:     // (This is only the HardwareState structure itself, not the buffer it
        !          3266:     // points to.)
        !          3267:     //
        !          3268: 
        !          3269:     if (HardwareStateSize < sizeof(VIDEO_HARDWARE_STATE) ) {
        !          3270: 
        !          3271:         *OutputSize = 0;  // nothing returned
        !          3272:         return ERROR_INSUFFICIENT_BUFFER;
        !          3273: 
        !          3274:     }
        !          3275: 
        !          3276:     //
        !          3277:     // Amount of data we're going to return in the output buffer.
        !          3278:     // (The VIDEO_HARDWARE_STATE in the output buffer points to the actual
        !          3279:     // buffer in which the state is stored, which is assumed to be large
        !          3280:     // enough.)
        !          3281:     //
        !          3282: 
        !          3283:     *OutputSize = sizeof(VIDEO_HARDWARE_STATE);
        !          3284: 
        !          3285:     //
        !          3286:     // Indicate the size of the full state save info.
        !          3287:     //
        !          3288: 
        !          3289:     HardwareState->StateLength = VGA_TOTAL_STATE_SIZE;
        !          3290: 
        !          3291:     //
        !          3292:     // hardwareStateHeader is a structure of offsets at the start of the
        !          3293:     // actual save area that indicates the locations in which various VGA
        !          3294:     // register and memory components are saved.
        !          3295:     //
        !          3296: 
        !          3297:     hardwareStateHeader = HardwareState->StateHeader;
        !          3298: 
        !          3299:     //
        !          3300:     // Zero out the structure.
        !          3301:     //
        !          3302: 
        !          3303:     VideoPortZeroMemory(hardwareStateHeader, sizeof(VIDEO_HARDWARE_STATE_HEADER));
        !          3304: 
        !          3305:     //
        !          3306:     // Set the Length field, which is basically a version ID.
        !          3307:     //
        !          3308: 
        !          3309:     hardwareStateHeader->Length = sizeof(VIDEO_HARDWARE_STATE_HEADER);
        !          3310: 
        !          3311:     //
        !          3312:     // Set the basic register offsets properly.
        !          3313:     //
        !          3314: 
        !          3315:     hardwareStateHeader->BasicSequencerOffset = VGA_BASIC_SEQUENCER_OFFSET;
        !          3316:     hardwareStateHeader->BasicCrtContOffset = VGA_BASIC_CRTC_OFFSET;
        !          3317:     hardwareStateHeader->BasicGraphContOffset = VGA_BASIC_GRAPH_CONT_OFFSET;
        !          3318:     hardwareStateHeader->BasicAttribContOffset = VGA_BASIC_ATTRIB_CONT_OFFSET;
        !          3319:     hardwareStateHeader->BasicDacOffset = VGA_BASIC_DAC_OFFSET;
        !          3320:     hardwareStateHeader->BasicLatchesOffset = VGA_BASIC_LATCHES_OFFSET;
        !          3321: 
        !          3322:     //
        !          3323:     // Set the entended register offsets properly.
        !          3324:     //
        !          3325: 
        !          3326:     hardwareStateHeader->ExtendedSequencerOffset = VGA_EXT_SEQUENCER_OFFSET;
        !          3327:     hardwareStateHeader->ExtendedCrtContOffset = VGA_EXT_CRTC_OFFSET;
        !          3328:     hardwareStateHeader->ExtendedGraphContOffset = VGA_EXT_GRAPH_CONT_OFFSET;
        !          3329:     hardwareStateHeader->ExtendedAttribContOffset = VGA_EXT_ATTRIB_CONT_OFFSET;
        !          3330:     hardwareStateHeader->ExtendedDacOffset = VGA_EXT_DAC_OFFSET;
        !          3331: 
        !          3332:     //
        !          3333:     // Figure out if color/mono switchable registers are at 3BX or 3DX.
        !          3334:     // At the same time, save the state of the Miscellaneous Output register
        !          3335:     // which is read from 3CC but written at 3C2.
        !          3336:     //
        !          3337: 
        !          3338:     if ((hardwareStateHeader->PortValue[MISC_OUTPUT_REG_WRITE_PORT] =
        !          3339:             VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3340:                     MISC_OUTPUT_REG_READ_PORT))
        !          3341:             & 0x01) {
        !          3342:         bIsColor = TRUE;
        !          3343:     } else {
        !          3344:         bIsColor = FALSE;
        !          3345:     }
        !          3346: 
        !          3347:     //
        !          3348:     // Force the video subsystem enable state to enabled.
        !          3349:     //
        !          3350: 
        !          3351:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3352:             VIDEO_SUBSYSTEM_ENABLE_PORT, 1);
        !          3353: 
        !          3354:     //
        !          3355:     // Save the DAC state first, so we can set the DAC to blank the screen
        !          3356:     // so nothing after this shows up at all.
        !          3357:     //
        !          3358:     // Save the DAC Mask register.
        !          3359:     //
        !          3360: 
        !          3361:     hardwareStateHeader->PortValue[DAC_PIXEL_MASK_PORT] =
        !          3362:             VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3363:                     DAC_PIXEL_MASK_PORT);
        !          3364: 
        !          3365:     //
        !          3366:     // Save the DAC Index register. Note that there is actually only one DAC
        !          3367:     // Index register, which functions as either the Read Index or the Write
        !          3368:     // Index as needed.
        !          3369:     //
        !          3370: 
        !          3371:     hardwareStateHeader->PortValue[DAC_ADDRESS_WRITE_PORT] =
        !          3372:             VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3373:                     DAC_ADDRESS_WRITE_PORT);
        !          3374: 
        !          3375:     //
        !          3376:     // Save the DAC read/write state. We determine if the DAC has been written
        !          3377:     // to or read from at the current index 0, 1, or 2 times (the application
        !          3378:     // is in the middle of reading or writing a DAC register triplet if the
        !          3379:     // count is 1 or 2), and save enough info so we can restore things
        !          3380:     // properly. The only hole is if the application writes to the Write Index,
        !          3381:     // then reads from instead of writes to the Data register, or vice-versa,
        !          3382:     // or if they do a partial read write, then never finish it.
        !          3383:     // This is fairly ridiculous behavior, however, and anyway there's nothing
        !          3384:     // we can do about it.
        !          3385:     //
        !          3386: 
        !          3387:     hardwareStateHeader->PortValue[DAC_STATE_PORT] =
        !          3388:              VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3389:                     DAC_STATE_PORT);
        !          3390: 
        !          3391:     if (hardwareStateHeader->PortValue[DAC_STATE_PORT] == 3) {
        !          3392: 
        !          3393:         //
        !          3394:         // The DAC Read Index was written to last. Figure out how many reads
        !          3395:         // have been done from the current index. We'll restart this on restore
        !          3396:         // by setting the Read Index to the current index - 1 (the read index
        !          3397:         // is one greater than the index being read), then doing the proper
        !          3398:         // number of reads.
        !          3399:         //
        !          3400:         // Read the Data register once, and see if the index changes.
        !          3401:         //
        !          3402: 
        !          3403:         dummy = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3404:                 DAC_DATA_REG_PORT);
        !          3405: 
        !          3406:         if (VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3407:                     DAC_ADDRESS_WRITE_PORT) !=
        !          3408:                 hardwareStateHeader->PortValue[DAC_ADDRESS_WRITE_PORT]) {
        !          3409: 
        !          3410:             //
        !          3411:             // The DAC Index changed, so two reads had already been done from
        !          3412:             // the current index. Store the count "2" in the upper nibble of
        !          3413:             // the read/write state field.
        !          3414:             //
        !          3415: 
        !          3416:             hardwareStateHeader->PortValue[DAC_STATE_PORT] |= 0x20;
        !          3417: 
        !          3418:         } else {
        !          3419: 
        !          3420:             //
        !          3421:             // Read the Data register again, and see if the index changes.
        !          3422:             //
        !          3423: 
        !          3424:             dummy = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3425:                     DAC_DATA_REG_PORT);
        !          3426: 
        !          3427:             if (VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3428:                         DAC_ADDRESS_WRITE_PORT) !=
        !          3429:                     hardwareStateHeader->PortValue[DAC_ADDRESS_WRITE_PORT]) {
        !          3430: 
        !          3431:                 //
        !          3432:                 // The DAC Index changed, so one read had already been done
        !          3433:                 // from the current index. Store the count "1" in the upper
        !          3434:                 // nibble of the read/write state field.
        !          3435:                 //
        !          3436: 
        !          3437:                 hardwareStateHeader->PortValue[DAC_STATE_PORT] |= 0x10;
        !          3438:             }
        !          3439: 
        !          3440:             //
        !          3441:             // If neither 2 nor 1 reads had been done from the current index,
        !          3442:             // then 0 reads were done, and we're all set, since the upper
        !          3443:             // nibble of the read/write state field is already 0.
        !          3444:             //
        !          3445: 
        !          3446:         }
        !          3447: 
        !          3448:     } else {
        !          3449: 
        !          3450:         //
        !          3451:         // The DAC Write Index was written to last. Figure out how many writes
        !          3452:         // have been done to the current index. We'll restart this on restore
        !          3453:         // by setting the Write Index to the proper index, then doing the
        !          3454:         // proper number of writes. When we do the DAC register save, we'll
        !          3455:         // read out the value that gets written (if there was a partial write
        !          3456:         // in progress), so we can restore the proper data later. This will
        !          3457:         // cause this current DAC location to be briefly wrong in the 1- and
        !          3458:         // 2-bytes-written case (until the app finishes the write), but that's
        !          3459:         // better than having the wrong DAC values written for good.
        !          3460:         //
        !          3461:         // Write the Data register once, and see if the index changes.
        !          3462:         //
        !          3463: 
        !          3464:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3465:                 DAC_DATA_REG_PORT, 0);
        !          3466: 
        !          3467:         if (VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3468:                     DAC_ADDRESS_WRITE_PORT) !=
        !          3469:                 hardwareStateHeader->PortValue[DAC_ADDRESS_WRITE_PORT]) {
        !          3470: 
        !          3471:             //
        !          3472:             // The DAC Index changed, so two writes had already been done to
        !          3473:             // the current index. Store the count "2" in the upper nibble of
        !          3474:             // the read/write state field.
        !          3475:             //
        !          3476: 
        !          3477:             hardwareStateHeader->PortValue[DAC_STATE_PORT] |= 0x20;
        !          3478: 
        !          3479:         } else {
        !          3480: 
        !          3481:             //
        !          3482:             // Write the Data register again, and see if the index changes.
        !          3483:             //
        !          3484: 
        !          3485:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3486:                     DAC_DATA_REG_PORT, 0);
        !          3487: 
        !          3488:             if (VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3489:                         DAC_ADDRESS_WRITE_PORT) !=
        !          3490:                     hardwareStateHeader->PortValue[DAC_ADDRESS_WRITE_PORT]) {
        !          3491: 
        !          3492:                 //
        !          3493:                 // The DAC Index changed, so one write had already been done
        !          3494:                 // to the current index. Store the count "1" in the upper
        !          3495:                 // nibble of the read/write state field.
        !          3496:                 //
        !          3497: 
        !          3498:                 hardwareStateHeader->PortValue[DAC_STATE_PORT] |= 0x10;
        !          3499:             }
        !          3500: 
        !          3501:             //
        !          3502:             // If neither 2 nor 1 writes had been done to the current index,
        !          3503:             // then 0 writes were done, and we're all set.
        !          3504:             //
        !          3505: 
        !          3506:         }
        !          3507: 
        !          3508:     }
        !          3509: 
        !          3510: 
        !          3511:     //
        !          3512:     // Now, read out the 256 18-bit DAC palette registers (256 RGB triplets),
        !          3513:     // and blank the screen.
        !          3514:     //
        !          3515: 
        !          3516:     portValueDAC = (PUCHAR) hardwareStateHeader + VGA_BASIC_DAC_OFFSET;
        !          3517: 
        !          3518:     //
        !          3519:     // Read out DAC register 0, so we can set it to black.
        !          3520:     //
        !          3521: 
        !          3522:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3523:                 DAC_ADDRESS_READ_PORT, 0);
        !          3524:     *portValueDAC++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3525:             DAC_DATA_REG_PORT);
        !          3526:     *portValueDAC++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3527:             DAC_DATA_REG_PORT);
        !          3528:     *portValueDAC++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3529:             DAC_DATA_REG_PORT);
        !          3530: 
        !          3531:     //
        !          3532:     // Set DAC register 0 to display black.
        !          3533:     //
        !          3534: 
        !          3535:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3536:             DAC_ADDRESS_WRITE_PORT, 0);
        !          3537:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3538:             DAC_DATA_REG_PORT, 0);
        !          3539:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3540:             DAC_DATA_REG_PORT, 0);
        !          3541:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3542:             DAC_DATA_REG_PORT, 0);
        !          3543: 
        !          3544:     //
        !          3545:     // Set the DAC mask register to force DAC register 0 to display all the
        !          3546:     // time (this is the register we just set to display black). From now on,
        !          3547:     // nothing but black will show up on the screen.
        !          3548:     //
        !          3549: 
        !          3550:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3551:             DAC_PIXEL_MASK_PORT, 0);
        !          3552: 
        !          3553:     //
        !          3554:     // Wait until we've gotten the Attribute Controller toggle state to save
        !          3555:     // the rest of the DAC registers, so we can wait for vertical sync.
        !          3556:     //
        !          3557: 
        !          3558: 
        !          3559:     //
        !          3560:     // Read out the Attribute Controller Index state, and deduce the Index/Data
        !          3561:     // toggle state at the same time.
        !          3562:     //
        !          3563:     // Save the state of the Attribute Controller, both Index and Data,
        !          3564:     // so we can test in which state the toggle currently is.
        !          3565:     //
        !          3566: 
        !          3567:     originalACIndex = hardwareStateHeader->PortValue[ATT_ADDRESS_PORT] =
        !          3568:             VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3569:                     ATT_ADDRESS_PORT);
        !          3570:     originalACData = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3571:             ATT_DATA_READ_PORT);
        !          3572: 
        !          3573:     //
        !          3574:     // Sequencer Index.
        !          3575:     //
        !          3576: 
        !          3577:     hardwareStateHeader->PortValue[SEQ_ADDRESS_PORT] =
        !          3578:              VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3579:                      SEQ_ADDRESS_PORT);
        !          3580: 
        !          3581:     //
        !          3582:     // Begin sync reset, just in case this is an SVGA and the currently
        !          3583:     // indexed Attribute Controller register controls clocking stuff (a
        !          3584:     // normal VGA won't require this).
        !          3585:     //
        !          3586: 
        !          3587:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          3588:             SEQ_ADDRESS_PORT),
        !          3589:             (USHORT) (IND_SYNC_RESET + (START_SYNC_RESET_VALUE << 8)));
        !          3590: 
        !          3591:     //
        !          3592:     // Now, write a different Index setting to the Attribute Controller, and
        !          3593:     // see if the Index changes.
        !          3594:     //
        !          3595: 
        !          3596:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3597:             ATT_ADDRESS_PORT, (UCHAR) (originalACIndex ^ 0x10));
        !          3598: 
        !          3599:     if (VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3600:                 ATT_ADDRESS_PORT) == originalACIndex) {
        !          3601: 
        !          3602:         //
        !          3603:         // The Index didn't change, so the toggle was in the Data state.
        !          3604:         //
        !          3605: 
        !          3606:         hardwareStateHeader->AttribIndexDataState = 1;
        !          3607: 
        !          3608:         //
        !          3609:         // Restore the original Data state; we just corrupted it, and we need
        !          3610:         // to read it out later; also, it may glitch the screen if not
        !          3611:         // corrected. The toggle is already in the Index state.
        !          3612:         //
        !          3613: 
        !          3614:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3615:                 ATT_ADDRESS_PORT, originalACIndex);
        !          3616:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3617:                 ATT_DATA_WRITE_PORT, originalACData);
        !          3618: 
        !          3619:     } else {
        !          3620: 
        !          3621:         //
        !          3622:         // The Index did change, so the toggle was in the Index state.
        !          3623:         // No need to restore anything, because the Data register didn't
        !          3624:         // change, and we've already read out the Index register.
        !          3625:         //
        !          3626: 
        !          3627:         hardwareStateHeader->AttribIndexDataState = 0;
        !          3628: 
        !          3629:     }
        !          3630: 
        !          3631:     //
        !          3632:     // End sync reset.
        !          3633:     //
        !          3634: 
        !          3635:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          3636:             SEQ_ADDRESS_PORT),
        !          3637:             (USHORT) (IND_SYNC_RESET + (END_SYNC_RESET_VALUE << 8)));
        !          3638: 
        !          3639: 
        !          3640: 
        !          3641:     //
        !          3642:     // Save the rest of the DAC registers.
        !          3643:     // Set the DAC address port Index, then read out the DAC Data registers.
        !          3644:     // Each three reads get Red, Green, and Blue components for that register.
        !          3645:     //
        !          3646:     // Read them one at a time due to problems on local bus machines.
        !          3647:     //
        !          3648: 
        !          3649:     for (i = 1; i < VGA_NUM_DAC_ENTRIES; i++) {
        !          3650: 
        !          3651:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3652:                                 DAC_ADDRESS_READ_PORT, (UCHAR)i);
        !          3653: 
        !          3654:         *portValueDAC++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3655:                                                  DAC_DATA_REG_PORT);
        !          3656: 
        !          3657:         *portValueDAC++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3658:                                                  DAC_DATA_REG_PORT);
        !          3659: 
        !          3660:         *portValueDAC++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3661:                                                  DAC_DATA_REG_PORT);
        !          3662: 
        !          3663:     }
        !          3664: 
        !          3665:     //
        !          3666:     // The Feature Control register is read from 3CA but written at 3BA/3DA.
        !          3667:     //
        !          3668: 
        !          3669:     if (bIsColor) {
        !          3670: 
        !          3671:         hardwareStateHeader->PortValue[FEAT_CTRL_WRITE_PORT_COLOR] =
        !          3672:                 VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3673:                         FEAT_CTRL_READ_PORT);
        !          3674: 
        !          3675:     } else {
        !          3676: 
        !          3677:         hardwareStateHeader->PortValue[FEAT_CTRL_WRITE_PORT_MONO] =
        !          3678:                 VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3679:                         FEAT_CTRL_READ_PORT);
        !          3680: 
        !          3681:     }
        !          3682: 
        !          3683: 
        !          3684: 
        !          3685:     //
        !          3686:     // CRT Controller Index.
        !          3687:     //
        !          3688: 
        !          3689:     if (bIsColor) {
        !          3690: 
        !          3691:         hardwareStateHeader->PortValue[CRTC_ADDRESS_PORT_COLOR] =
        !          3692:                 VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3693:                         CRTC_ADDRESS_PORT_COLOR);
        !          3694: 
        !          3695:     } else {
        !          3696: 
        !          3697:         hardwareStateHeader->PortValue[CRTC_ADDRESS_PORT_MONO] =
        !          3698:                 VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3699:                         CRTC_ADDRESS_PORT_MONO);
        !          3700: 
        !          3701:     }
        !          3702: 
        !          3703: 
        !          3704:     //
        !          3705:     // Graphics Controller Index.
        !          3706:     //
        !          3707: 
        !          3708:     hardwareStateHeader->PortValue[GRAPH_ADDRESS_PORT] =
        !          3709:             VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3710:                     GRAPH_ADDRESS_PORT);
        !          3711: 
        !          3712: 
        !          3713:     //
        !          3714:     // Graphics Controller indexed registers.
        !          3715:     //
        !          3716: 
        !          3717:     portValue = (PUCHAR) hardwareStateHeader + VGA_BASIC_GRAPH_CONT_OFFSET;
        !          3718: 
        !          3719:     for (i = 0; i < VGA_NUM_GRAPH_CONT_PORTS; i++) {
        !          3720: 
        !          3721:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3722:                 GRAPH_ADDRESS_PORT, (UCHAR)i);
        !          3723:         *portValue++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3724:                 GRAPH_DATA_PORT);
        !          3725: 
        !          3726:     }
        !          3727: 
        !          3728:     //
        !          3729:     // Save extended graphics controller registers.
        !          3730:     //
        !          3731: 
        !          3732: #ifdef EXTENDED_REGISTER_SAVE_RESTORE
        !          3733: 
        !          3734:     //
        !          3735:     // Read the lock register (index 0x0F) value and save that.
        !          3736:     //
        !          3737: 
        !          3738:     *(((PUCHAR) hardwareStateHeader) + VGA_EXT_GRAPH_CONT_OFFSET +
        !          3739:     (WD_GRAPH_EXT_END - WD_GRAPH_EXT_START)) =
        !          3740:        VideoPortReadPortUchar(HwDeviceExtension->IOAddress + 0x0F);
        !          3741: 
        !          3742:     //
        !          3743:     // Unlock all extended registers so they can be read or written.
        !          3744:     //
        !          3745: 
        !          3746:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress + 0x0F, 0x05);
        !          3747: 
        !          3748:     portValue = (PUCHAR) hardwareStateHeader + VGA_EXT_GRAPH_CONT_OFFSET;
        !          3749: 
        !          3750:     for (i = WD_GRAPH_EXT_START; i <= WD_GRAPH_EXT_END -1; i++) {
        !          3751: 
        !          3752:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3753:                                 GRAPH_ADDRESS_PORT, (UCHAR)i);
        !          3754: 
        !          3755:         *portValue++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3756:                                               GRAPH_DATA_PORT);
        !          3757: 
        !          3758:     }
        !          3759: 
        !          3760: #endif
        !          3761: 
        !          3762:     //
        !          3763:     // Sequencer indexed registers.
        !          3764:     //
        !          3765: 
        !          3766:     portValue = ((PUCHAR) hardwareStateHeader) + VGA_BASIC_SEQUENCER_OFFSET;
        !          3767: 
        !          3768:     for (i = 0; i < VGA_NUM_SEQUENCER_PORTS; i++) {
        !          3769: 
        !          3770:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3771:                 SEQ_ADDRESS_PORT, (UCHAR)i);
        !          3772:         *portValue++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3773:                 SEQ_DATA_PORT);
        !          3774: 
        !          3775:     }
        !          3776: 
        !          3777: 
        !          3778:     //
        !          3779:     // Save extended sequencer registers.
        !          3780:     //
        !          3781: 
        !          3782: #ifdef EXTENDED_REGISTER_SAVE_RESTORE
        !          3783: 
        !          3784:     portValue = ((PUCHAR) hardwareStateHeader) + VGA_EXT_SEQUENCER_OFFSET;
        !          3785: 
        !          3786:     for (i = WD_SEQUENCER_EXT_START; i <= WD_SEQUENCER_EXT_END; i++) {
        !          3787: 
        !          3788:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3789:                                 SEQ_ADDRESS_PORT, (UCHAR)i);
        !          3790: 
        !          3791:         *portValue++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3792:                                               SEQ_DATA_PORT);
        !          3793: 
        !          3794:     }
        !          3795: 
        !          3796:     //
        !          3797:     // Second set of sequencer registers
        !          3798:     //
        !          3799: 
        !          3800:     for (i = WD_SEQUENCER_1_EXT_START; i <= WD_SEQUENCER_1_EXT_END; i++) {
        !          3801: 
        !          3802:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3803:                                 SEQ_ADDRESS_PORT, (UCHAR)i);
        !          3804: 
        !          3805:         *portValue++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3806:                                               SEQ_DATA_PORT);
        !          3807: 
        !          3808:     }
        !          3809: 
        !          3810: #endif
        !          3811: 
        !          3812:     //
        !          3813:     // CRT Controller indexed registers.
        !          3814:     //
        !          3815: 
        !          3816:     //
        !          3817:     // Remember the state of CRTC register 3, then force bit 7
        !          3818:     // to 1 so we will read back the Vertical Retrace start and
        !          3819:     // end registers rather than the light pen info.
        !          3820:     //
        !          3821: 
        !          3822:     if (bIsColor) {
        !          3823: 
        !          3824:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3825:                 CRTC_ADDRESS_PORT_COLOR, 3);
        !          3826:         ucCRTC03 = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3827:                         CRTC_DATA_PORT_COLOR);
        !          3828:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3829:                     CRTC_DATA_PORT_COLOR, (UCHAR) (ucCRTC03 | 0x80));
        !          3830:     } else {
        !          3831: 
        !          3832:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3833:                 CRTC_ADDRESS_PORT_MONO, 3);
        !          3834:         ucCRTC03 = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3835:                         CRTC_DATA_PORT_MONO);
        !          3836:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3837:                 CRTC_DATA_PORT_MONO, (UCHAR) (ucCRTC03 | 0x80));
        !          3838:     }
        !          3839: 
        !          3840:     portValue = (PUCHAR) hardwareStateHeader + VGA_BASIC_CRTC_OFFSET;
        !          3841: 
        !          3842:     for (i = 0; i < VGA_NUM_CRTC_PORTS; i++) {
        !          3843: 
        !          3844:         if (bIsColor) {
        !          3845: 
        !          3846:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3847:                     CRTC_ADDRESS_PORT_COLOR, (UCHAR)i);
        !          3848:             *portValue++ =
        !          3849:                     VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3850:                             CRTC_DATA_PORT_COLOR);
        !          3851:         } else {
        !          3852: 
        !          3853:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3854:                     CRTC_ADDRESS_PORT_MONO, (UCHAR)i);
        !          3855:             *portValue++ =
        !          3856:                     VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3857:                             CRTC_DATA_PORT_MONO);
        !          3858:         }
        !          3859: 
        !          3860:     }
        !          3861: 
        !          3862:     portValue = (PUCHAR) hardwareStateHeader + VGA_BASIC_CRTC_OFFSET;
        !          3863:     portValue[3] = ucCRTC03;
        !          3864: 
        !          3865: 
        !          3866:     //
        !          3867:     // Save extended crtc registers.
        !          3868:     //
        !          3869: 
        !          3870: #ifdef EXTENDED_REGISTER_SAVE_RESTORE
        !          3871: 
        !          3872:     portValue = (PUCHAR) hardwareStateHeader + VGA_EXT_CRTC_OFFSET;
        !          3873: 
        !          3874:     for (i = WD_CRTC_EXT_START; i <= WD_CRTC_EXT_END; i++) {
        !          3875: 
        !          3876:         if (bIsColor) {
        !          3877: 
        !          3878:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3879:                                     CRTC_ADDRESS_PORT_COLOR, (UCHAR)i);
        !          3880: 
        !          3881:             *portValue++ =
        !          3882:                 VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3883:                                        CRTC_DATA_PORT_COLOR);
        !          3884: 
        !          3885:         } else {
        !          3886: 
        !          3887:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3888:                                     CRTC_ADDRESS_PORT_MONO, (UCHAR)i);
        !          3889: 
        !          3890:             *portValue++ = 
        !          3891:                 VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3892:                                        CRTC_DATA_PORT_MONO);
        !          3893:         }
        !          3894:     }
        !          3895: 
        !          3896:     //
        !          3897:     // Save second set of crtc registers.
        !          3898:     //
        !          3899: 
        !          3900:     for (i = WD_CRTC_1_EXT_START; i <= WD_CRTC_1_EXT_END; i++) {
        !          3901: 
        !          3902:         if (bIsColor) {
        !          3903: 
        !          3904:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3905:                                     CRTC_ADDRESS_PORT_COLOR, (UCHAR)i);
        !          3906: 
        !          3907:             *portValue++ =
        !          3908:                 VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3909:                                        CRTC_DATA_PORT_COLOR);
        !          3910: 
        !          3911:         } else {
        !          3912: 
        !          3913:             VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3914:                                     CRTC_ADDRESS_PORT_MONO, (UCHAR)i);
        !          3915: 
        !          3916:             *portValue++ = 
        !          3917:                 VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3918:                                        CRTC_DATA_PORT_MONO);
        !          3919:         }
        !          3920:     }
        !          3921: 
        !          3922: #endif
        !          3923: 
        !          3924:     //
        !          3925:     // Attribute Controller indexed registers.
        !          3926:     //
        !          3927: 
        !          3928:     portValue = (PUCHAR) hardwareStateHeader + VGA_BASIC_ATTRIB_CONT_OFFSET;
        !          3929: 
        !          3930:     //
        !          3931:     // For each indexed AC register, reset the flip-flop for reading the
        !          3932:     // attribute register, then write the desired index to the AC Index,
        !          3933:     // then read the value of the indexed register from the AC Data register.
        !          3934:     //
        !          3935: 
        !          3936:     for (i = 0; i < VGA_NUM_ATTRIB_CONT_PORTS; i++) {
        !          3937: 
        !          3938:         if (bIsColor) {
        !          3939:             dummy = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3940:                     INPUT_STATUS_1_COLOR);
        !          3941:         } else {
        !          3942:             dummy = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3943:                     INPUT_STATUS_1_MONO);
        !          3944:         }
        !          3945: 
        !          3946:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3947:                 ATT_ADDRESS_PORT, (UCHAR)i);
        !          3948:         *portValue++ = VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3949:                 ATT_DATA_READ_PORT);
        !          3950: 
        !          3951:     }
        !          3952: 
        !          3953:     //
        !          3954:     // Save the latches. This destroys one byte of display memory in each
        !          3955:     // plane, which is unfortunate but unavoidable. Chips that provide
        !          3956:     // a way to read back the latches can avoid this problem.
        !          3957:     //
        !          3958:     // Set up the VGA's hardware so we can write the latches, then read them
        !          3959:     // back.
        !          3960:     //
        !          3961: 
        !          3962:     //
        !          3963:     // Begin sync reset.
        !          3964:     //
        !          3965: 
        !          3966:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          3967:             SEQ_ADDRESS_PORT),
        !          3968:             (USHORT) (IND_SYNC_RESET + (START_SYNC_RESET_VALUE << 8)));
        !          3969: 
        !          3970:     //
        !          3971:     // Set the Miscellaneous register to make sure we can access video RAM.
        !          3972:     //
        !          3973: 
        !          3974:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3975:             MISC_OUTPUT_REG_WRITE_PORT, (UCHAR)(
        !          3976:             hardwareStateHeader->PortValue[MISC_OUTPUT_REG_WRITE_PORT] |
        !          3977:             0x02));
        !          3978: 
        !          3979:     //
        !          3980:     // Turn off Chain mode and map display memory at A0000 for 64K.
        !          3981:     //
        !          3982: 
        !          3983:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3984:             GRAPH_ADDRESS_PORT, IND_GRAPH_MISC);
        !          3985:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3986:             GRAPH_DATA_PORT,
        !          3987:             (UCHAR) ((VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3988:             GRAPH_DATA_PORT) & 0xF1) | 0x04));
        !          3989: 
        !          3990:     //
        !          3991:     // Turn off Chain4 mode and odd/even.
        !          3992:     //
        !          3993: 
        !          3994:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3995:             SEQ_ADDRESS_PORT, IND_MEMORY_MODE);
        !          3996:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          3997:             SEQ_DATA_PORT,
        !          3998:             (UCHAR) ((VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          3999:             SEQ_DATA_PORT) & 0xF3) | 0x04));
        !          4000: 
        !          4001:     //
        !          4002:     // End sync reset.
        !          4003:     //
        !          4004: 
        !          4005:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          4006:             SEQ_ADDRESS_PORT),
        !          4007:             (USHORT) (IND_SYNC_RESET + (END_SYNC_RESET_VALUE << 8)));
        !          4008: 
        !          4009:     //
        !          4010:     // Set the Map Mask to write to all planes.
        !          4011:     //
        !          4012: 
        !          4013:     VideoPortWritePortUshort((PUSHORT) (HwDeviceExtension->IOAddress +
        !          4014:             SEQ_ADDRESS_PORT), (USHORT) (IND_MAP_MASK + (0x0F << 8)));
        !          4015: 
        !          4016:     //
        !          4017:     // Set the write mode to 0, the read mode to 0, and turn off odd/even.
        !          4018:     //
        !          4019: 
        !          4020:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          4021:             GRAPH_ADDRESS_PORT, IND_GRAPH_MODE);
        !          4022:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          4023:             GRAPH_DATA_PORT,
        !          4024:             (UCHAR) ((VideoPortReadPortUchar(HwDeviceExtension->IOAddress +
        !          4025:             GRAPH_DATA_PORT) & 0xE4) | 0x01));
        !          4026: 
        !          4027:     //
        !          4028:     // Point to the last byte of display memory.
        !          4029:     //
        !          4030: 
        !          4031:     pScreen = (PUCHAR) HwDeviceExtension->VideoMemoryAddress +
        !          4032:             VGA_PLANE_SIZE - 1;
        !          4033: 
        !          4034:     //
        !          4035:     // Write the latches to the last byte of display memory.
        !          4036:     //
        !          4037: 
        !          4038:     VideoPortWriteRegisterUchar(pScreen, 0);
        !          4039: 
        !          4040:     //
        !          4041:     // Cycle through the four planes, reading the latch data from each plane.
        !          4042:     //
        !          4043: 
        !          4044:     //
        !          4045:     // Point the Graphics Controller Index to the Read Map register.
        !          4046:     //
        !          4047: 
        !          4048:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          4049:             GRAPH_ADDRESS_PORT, IND_READ_MAP);
        !          4050: 
        !          4051:     portValue = (PUCHAR) hardwareStateHeader + VGA_BASIC_LATCHES_OFFSET;
        !          4052: 
        !          4053:     for (i=0; i<4; i++) {
        !          4054: 
        !          4055:         //
        !          4056:         // Set the Read Map for the current plane.
        !          4057:         //
        !          4058: 
        !          4059:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          4060:                 GRAPH_DATA_PORT, (UCHAR)i);
        !          4061: 
        !          4062:         //
        !          4063:         // Read the latched data we've written to memory.
        !          4064:         //
        !          4065: 
        !          4066:         *portValue++ = VideoPortReadRegisterUchar(pScreen);
        !          4067: 
        !          4068:     }
        !          4069: 
        !          4070:     //
        !          4071:     // Set the VDM flags
        !          4072:     // We are a standard VGA, and then check if we have unemulated state.
        !          4073:     //
        !          4074: 
        !          4075:     hardwareStateHeader->VGAStateFlags = 0;
        !          4076: 
        !          4077: #ifdef EXTENDED_REGISTER_SAVE_RESTORE
        !          4078: 
        !          4079:     hardwareStateHeader->VGAStateFlags |= VIDEO_STATE_NON_STANDARD_VGA;
        !          4080: 
        !          4081: #endif
        !          4082: 
        !          4083:     if (HwDeviceExtension->TrappedValidatorCount) {
        !          4084: 
        !          4085:         hardwareStateHeader->VGAStateFlags |= VIDEO_STATE_UNEMULATED_VGA_STATE;
        !          4086: 
        !          4087:         //
        !          4088:         // Save the VDM Emulator data
        !          4089:         // No need to save the state of the seuencer port register for our
        !          4090:         // emulated data since it may change when we come back. It will be
        !          4091:         // recomputed.
        !          4092:         //
        !          4093: 
        !          4094:         hardwareStateHeader->ExtendedValidatorStateOffset = VGA_VALIDATOR_OFFSET;
        !          4095: 
        !          4096:         VideoPortMoveMemory(((PUCHAR) (hardwareStateHeader)) +
        !          4097:                                 hardwareStateHeader->ExtendedValidatorStateOffset,
        !          4098:                             &(HwDeviceExtension->TrappedValidatorCount),
        !          4099:                             VGA_VALIDATOR_AREA_SIZE);
        !          4100: 
        !          4101:     } else {
        !          4102: 
        !          4103:         hardwareStateHeader->ExtendedValidatorStateOffset = 0;
        !          4104: 
        !          4105:     }
        !          4106: 
        !          4107:     //
        !          4108:     // Set the size of each plane.
        !          4109:     //
        !          4110: 
        !          4111:     hardwareStateHeader->PlaneLength = VGA_PLANE_SIZE;
        !          4112: 
        !          4113:     //
        !          4114:     // Store all the offsets for the planes in the structure.
        !          4115:     //
        !          4116: 
        !          4117:     hardwareStateHeader->Plane1Offset = VGA_PLANE_0_OFFSET;
        !          4118:     hardwareStateHeader->Plane2Offset = VGA_PLANE_1_OFFSET;
        !          4119:     hardwareStateHeader->Plane3Offset = VGA_PLANE_2_OFFSET;
        !          4120:     hardwareStateHeader->Plane4Offset = VGA_PLANE_3_OFFSET;
        !          4121: 
        !          4122:     //
        !          4123:     // Now copy the contents of video VRAM into the buffer.
        !          4124:     //
        !          4125:     // The VGA hardware is already set up so that video memory is readable;
        !          4126:     // we already turned off Chain mode, mapped in at A0000, turned off Chain4,
        !          4127:     // turned off odd/even, and set read mode 0 when we saved the latches.
        !          4128:     //
        !          4129:     // Point the Graphics Controller Index to the Read Map register.
        !          4130:     //
        !          4131: 
        !          4132:     VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          4133:             GRAPH_ADDRESS_PORT, IND_READ_MAP);
        !          4134: 
        !          4135:     //
        !          4136:     // Point to the save area for the first plane.
        !          4137:     //
        !          4138: 
        !          4139:     bufferPointer = ((PUCHAR) (hardwareStateHeader)) +
        !          4140:                      hardwareStateHeader->Plane1Offset;
        !          4141: 
        !          4142:     //
        !          4143:     // Save the four planes consecutively.
        !          4144:     //
        !          4145: 
        !          4146:     for (i = 0; i < 4; i++) {
        !          4147: 
        !          4148:         //
        !          4149:         // Set the Read Map to select the plane we want to save next.
        !          4150:         //
        !          4151: 
        !          4152:         VideoPortWritePortUchar(HwDeviceExtension->IOAddress +
        !          4153:                 GRAPH_DATA_PORT, (UCHAR)i);
        !          4154: 
        !          4155:         //
        !          4156:         // Copy this plane into the buffer.
        !          4157:         //
        !          4158: 
        !          4159:         VideoPortMoveMemory(bufferPointer,
        !          4160:                            (PUCHAR) HwDeviceExtension->VideoMemoryAddress,
        !          4161:                            VGA_PLANE_SIZE);
        !          4162:         //
        !          4163:         // Point to the next plane's save area.
        !          4164:         //
        !          4165: 
        !          4166:         bufferPointer += VGA_PLANE_SIZE;
        !          4167:     }
        !          4168: 
        !          4169:     return NO_ERROR;
        !          4170: 
        !          4171: } // end VgaSaveHardwareState()
        !          4172: 
        !          4173: VP_STATUS
        !          4174: VgaGetBankSelectCode(
        !          4175:     PHW_DEVICE_EXTENSION HwDeviceExtension,
        !          4176:     PVIDEO_BANK_SELECT BankSelect,
        !          4177:     ULONG BankSelectSize,
        !          4178:     PULONG OutputSize
        !          4179:     )
        !          4180: 
        !          4181: /*++
        !          4182: 
        !          4183: Routine Description:
        !          4184: 
        !          4185:     Returns information needed in order for caller to implement bank
        !          4186:          management.
        !          4187: 
        !          4188: Arguments:
        !          4189: 
        !          4190:     HwDeviceExtension - Pointer to the miniport driver's device extension.
        !          4191: 
        !          4192:     BankSelect - Pointer to a VIDEO_BANK_SELECT structure in which the bank
        !          4193:              select data will be returned (output buffer).
        !          4194: 
        !          4195:     BankSelectSize - Length of the output buffer supplied by the user.
        !          4196: 
        !          4197:     OutputSize - Pointer to a variable in which to return the actual size of
        !          4198:         the data returned in the output buffer.
        !          4199: 
        !          4200: Return Value:
        !          4201: 
        !          4202:     NO_ERROR - information returned successfully
        !          4203: 
        !          4204:     ERROR_MORE_DATA - output buffer not large enough to hold all info (but
        !          4205:         Size is returned, so caller can tell how large a buffer to allocate)
        !          4206: 
        !          4207:     ERROR_INSUFFICIENT_BUFFER - output buffer not large enough to return
        !          4208:         any useful data
        !          4209: 
        !          4210:     ERROR_INVALID_PARAMETER - invalid video mode selection
        !          4211: 
        !          4212: --*/
        !          4213: 
        !          4214: {
        !          4215:     ULONG codeSize;
        !          4216:     PUCHAR pCodeDest;
        !          4217:     PUCHAR pCodeBank;
        !          4218: 
        !          4219:     PVIDEOMODE pMode = HwDeviceExtension->CurrentMode;
        !          4220: 
        !          4221:     //
        !          4222:     // The minimum passed buffer size is a VIDEO_BANK_SELECT
        !          4223:     // structure, so that we can return the required size; we can't do
        !          4224:     // anything if we don't have at least that much buffer.
        !          4225:     //
        !          4226: 
        !          4227:     if (BankSelectSize < sizeof(VIDEO_BANK_SELECT)) {
        !          4228: 
        !          4229:             return ERROR_INSUFFICIENT_BUFFER;
        !          4230: 
        !          4231:     }
        !          4232: 
        !          4233:     //
        !          4234:     // Determine the banking type, and set whether any banking is actually
        !          4235:     // supported in this mode.
        !          4236:     //
        !          4237: 
        !          4238:     BankSelect->BankingFlags = 0;
        !          4239:     codeSize = 0;
        !          4240:     pCodeBank = NULL;
        !          4241: 
        !          4242:     switch(pMode->banktype) {
        !          4243: 
        !          4244:     case NoBanking:
        !          4245: 
        !          4246:         BankSelect->BankingType = VideoNotBanked;
        !          4247:         BankSelect->Granularity = 0;
        !          4248: 
        !          4249:         break;
        !          4250: 
        !          4251:     case PlanarHCBanking:
        !          4252: 
        !          4253:         VideoDebugPrint((0, "Unsupported planarHC banking\n"));
        !          4254: 
        !          4255:     //
        !          4256:     // Fall through to NormalBanking...
        !          4257:     //
        !          4258: 
        !          4259:     case NormalBanking:
        !          4260: 
        !          4261:         //
        !          4262:         // The WDVGA supports independent 64K read and write banks except
        !          4263:         // for the older ships that only have 1RW
        !          4264:         //
        !          4265: 
        !          4266:         if (HwDeviceExtension->BoardID <= WD90C00) {
        !          4267: 
        !          4268:             BankSelect->BankingType = VideoBanked1RW;
        !          4269: 
        !          4270:         } else {
        !          4271: 
        !          4272:             BankSelect->BankingType = VideoBanked1R1W;
        !          4273: 
        !          4274:         }
        !          4275: 
        !          4276:         BankSelect->Granularity = 0x10000;    // 64K bank start adjustment
        !          4277: 
        !          4278:         pCodeBank = &BankSwitchStart;
        !          4279:         codeSize = ((ULONG)&BankSwitchEnd) - ((ULONG)&BankSwitchStart);
        !          4280: 
        !          4281:         break;
        !          4282: 
        !          4283:     }
        !          4284: 
        !          4285:     //
        !          4286:     // Size of banking info.
        !          4287:     //
        !          4288: 
        !          4289:     BankSelect->Size = sizeof(VIDEO_BANK_SELECT) + codeSize;
        !          4290: 
        !          4291:     //
        !          4292:     // This serves an a ID for the version of the structure we're using.
        !          4293:     //
        !          4294: 
        !          4295:     BankSelect->Length = sizeof(VIDEO_BANK_SELECT);
        !          4296: 
        !          4297:     //
        !          4298:     // If the buffer isn't big enough to hold all info, just return
        !          4299:     // ERROR_MORE_DATA; Size is already set.
        !          4300:     //
        !          4301: 
        !          4302:     if (BankSelectSize < BankSelect->Size ) {
        !          4303: 
        !          4304:         //
        !          4305:         // We're returning only the VIDEO_BANK_SELECT structure.
        !          4306:         //
        !          4307: 
        !          4308:         *OutputSize = sizeof(VIDEO_BANK_SELECT);
        !          4309:         return ERROR_MORE_DATA;
        !          4310:     }
        !          4311: 
        !          4312:     //
        !          4313:     // There's room enough for everything, so fill in all fields in
        !          4314:     // VIDEO_BANK_SELECT. (All fields are always returned; the caller can
        !          4315:     // just choose to ignore them, based on BankingFlags and BankingType.)
        !          4316:     //
        !          4317: 
        !          4318:     BankSelect->BitmapWidthInBytes = pMode->wbytes;
        !          4319:     BankSelect->BitmapSize = pMode->sbytes;
        !          4320: 
        !          4321:     //
        !          4322:     // Copy all banking code into the output buffer.
        !          4323:     //
        !          4324: 
        !          4325:     pCodeDest = (PUCHAR)BankSelect + sizeof(VIDEO_BANK_SELECT);
        !          4326: 
        !          4327:     if (pCodeBank != NULL) {
        !          4328: 
        !          4329:         BankSelect->CodeOffset = pCodeDest - (PUCHAR)BankSelect;
        !          4330:         VideoPortMoveMemory(pCodeDest, pCodeBank, codeSize);
        !          4331:         pCodeDest += codeSize;
        !          4332:     }
        !          4333: 
        !          4334:     //
        !          4335:     // Number of bytes we're returning is the full banking info size.
        !          4336:     //
        !          4337: 
        !          4338:     *OutputSize = BankSelect->Size;
        !          4339: 
        !          4340:     return NO_ERROR;
        !          4341: 
        !          4342: } // end VgaGetBankSelectCode()
        !          4343: 
        !          4344: VP_STATUS
        !          4345: VgaValidatorUcharEntry(
        !          4346:     ULONG Context,
        !          4347:     ULONG Port,
        !          4348:     UCHAR AccessMode,
        !          4349:     PUCHAR Data
        !          4350:     )
        !          4351: 
        !          4352: /*++
        !          4353: 
        !          4354: Routine Description:
        !          4355: 
        !          4356:     Entry point into the validator for byte I/O operations.
        !          4357: 
        !          4358:     The entry point will be called whenever a byte operation was performed
        !          4359:     by a DOS application on one of the specified Video ports. The kernel
        !          4360:     emulator will forward these requests.
        !          4361: 
        !          4362: Arguments:
        !          4363: 
        !          4364:     Context - Context value that is passed to each call made to the validator
        !          4365:         function. This is the value the miniport driver specified in the
        !          4366:         MiniportConfigInfo->EmulatorAccessEntriesContext.
        !          4367: 
        !          4368:     Port - Port on which the operation is to be performed.
        !          4369: 
        !          4370:     AccessMode - Determines if it is a read or write operation.
        !          4371: 
        !          4372:     Data - Pointer to a variable containing the data to be written or a
        !          4373:         variable into which the read data should be stored.
        !          4374: 
        !          4375: Return Value:
        !          4376: 
        !          4377:     NO_ERROR.
        !          4378: 
        !          4379: --*/
        !          4380: 
        !          4381: {
        !          4382: 
        !          4383:     PHW_DEVICE_EXTENSION hwDeviceExtension = (PHW_DEVICE_EXTENSION) Context;
        !          4384:     ULONG endEmulation;
        !          4385:     UCHAR temp;
        !          4386: 
        !          4387:     Port -= VGA_BASE_IO_PORT;
        !          4388: 
        !          4389:     if (hwDeviceExtension->TrappedValidatorCount) {
        !          4390: 
        !          4391:         //
        !          4392:         // If we are processing a WRITE instruction, then store it in the
        !          4393:         // playback buffer. If the buffer is full, then play it back right
        !          4394:         // away, end sync reset and reinitialize the buffer with a sync
        !          4395:         // reset instruction.
        !          4396:         //
        !          4397:         // If we have a READ, we must flush the buffer (which has the side
        !          4398:         // effect of starting SyncReset), perform the read operation, stop
        !          4399:         // sync reset, and put back a sync reset instruction in the buffer
        !          4400:         // so we can go on appropriately
        !          4401:         //
        !          4402: 
        !          4403:         if (AccessMode & EMULATOR_WRITE_ACCESS) {
        !          4404: 
        !          4405:             //
        !          4406:             // Make sure Bit 3 of the Miscellaneous register is always 0.
        !          4407:             // If it is 1 it could select a non-existent clock, and kill the
        !          4408:             // system
        !          4409:             //
        !          4410: 
        !          4411:             if (Port == MISC_OUTPUT_REG_WRITE_PORT) {
        !          4412: 
        !          4413:                 *Data &= 0xF7;
        !          4414: 
        !          4415:             }
        !          4416: 
        !          4417:             hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4418:                 TrappedValidatorCount].Port = Port;
        !          4419: 
        !          4420:             hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4421:                 TrappedValidatorCount].AccessType = VGA_VALIDATOR_UCHAR_ACCESS;
        !          4422: 
        !          4423:             hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4424:                 TrappedValidatorCount].Data = *Data;
        !          4425: 
        !          4426:             hwDeviceExtension->TrappedValidatorCount++;
        !          4427: 
        !          4428:             //
        !          4429:             // Check to see if this instruction was ending sync reset.
        !          4430:             // If it did, we must flush the buffer and reset the trapped
        !          4431:             // IO ports to the minimal set.
        !          4432:             //
        !          4433: 
        !          4434:             if ( (Port == SEQ_DATA_PORT) &&
        !          4435:                  ((*Data & END_SYNC_RESET_VALUE) == END_SYNC_RESET_VALUE) &&
        !          4436:                  (hwDeviceExtension->SequencerAddressValue == IND_SYNC_RESET)) {
        !          4437: 
        !          4438:                 endEmulation = 1;
        !          4439: 
        !          4440:             } else {
        !          4441: 
        !          4442:                 //
        !          4443:                 // If we are accessing the seq address port, keep track of the
        !          4444:                 // data value
        !          4445:                 //
        !          4446: 
        !          4447:                 if (Port == SEQ_ADDRESS_PORT) {
        !          4448: 
        !          4449:                     hwDeviceExtension->SequencerAddressValue = *Data;
        !          4450: 
        !          4451:                 }
        !          4452:     
        !          4453:                 //
        !          4454:                 // If the buffer is not full, then just return right away.
        !          4455:                 //
        !          4456: 
        !          4457:                 if (hwDeviceExtension->TrappedValidatorCount <
        !          4458:                        VGA_MAX_VALIDATOR_DATA - 1) {
        !          4459: 
        !          4460:                     return NO_ERROR;
        !          4461: 
        !          4462:                 }
        !          4463: 
        !          4464:                 endEmulation = 0;
        !          4465:             }
        !          4466:         }
        !          4467: 
        !          4468:         //
        !          4469:         // We are either in a READ path or a WRITE path that caused a
        !          4470:         // a full buffer. So flush the buffer either way.
        !          4471:         //
        !          4472:         // To do this put an END_SYNC_RESET at the end since we want to make
        !          4473:         // the buffer is ended sync reset ended.
        !          4474:         //
        !          4475: 
        !          4476:         hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4477:             TrappedValidatorCount].Port = SEQ_ADDRESS_PORT;
        !          4478: 
        !          4479:         hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4480:             TrappedValidatorCount].AccessType = VGA_VALIDATOR_USHORT_ACCESS;
        !          4481: 
        !          4482:         hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4483:             TrappedValidatorCount].Data = (USHORT) (IND_SYNC_RESET +
        !          4484:                                           (END_SYNC_RESET_VALUE << 8));
        !          4485: 
        !          4486:         hwDeviceExtension->TrappedValidatorCount++;
        !          4487: 
        !          4488:         VideoPortSynchronizeExecution(hwDeviceExtension,
        !          4489:                                       VpHighPriority,
        !          4490:                                       (PMINIPORT_SYNCHRONIZE_ROUTINE)
        !          4491:                                           VgaPlaybackValidatorData,
        !          4492:                                       hwDeviceExtension);
        !          4493: 
        !          4494:         //
        !          4495:         // Write back the real value of the sequencer address port.
        !          4496:         //
        !          4497: 
        !          4498:         VideoPortWritePortUchar(hwDeviceExtension->IOAddress +
        !          4499:                                     SEQ_ADDRESS_PORT,
        !          4500:                                 (UCHAR) hwDeviceExtension->SequencerAddressValue);
        !          4501: 
        !          4502:         //
        !          4503:         // If we are in a READ path, read the data
        !          4504:         //
        !          4505: 
        !          4506:         if (AccessMode & EMULATOR_READ_ACCESS) {
        !          4507: 
        !          4508:             *Data = VideoPortReadPortUchar(hwDeviceExtension->IOAddress + Port);
        !          4509: 
        !          4510:             endEmulation = 0;
        !          4511: 
        !          4512:         }
        !          4513: 
        !          4514:         //
        !          4515:         // If we are ending emulation, reset trapping to the minimal amount
        !          4516:         // and exit.
        !          4517:         //
        !          4518: 
        !          4519:         if (endEmulation) {
        !          4520: 
        !          4521:             VideoPortSetTrappedEmulatorPorts(hwDeviceExtension,
        !          4522:                                              NUM_MINIMAL_VGA_VALIDATOR_ACCESS_RANGE,
        !          4523:                                              MinimalVgaValidatorAccessRange);
        !          4524: 
        !          4525:             return NO_ERROR;
        !          4526: 
        !          4527:         }
        !          4528: 
        !          4529:         //
        !          4530:         // For both cases, put back a START_SYNC_RESET in the buffer.
        !          4531:         //
        !          4532: 
        !          4533:         hwDeviceExtension->TrappedValidatorCount = 1;
        !          4534: 
        !          4535:         hwDeviceExtension->TrappedValidatorData[0].Port = SEQ_ADDRESS_PORT;
        !          4536: 
        !          4537:         hwDeviceExtension->TrappedValidatorData[0].AccessType =
        !          4538:                 VGA_VALIDATOR_USHORT_ACCESS;
        !          4539: 
        !          4540:         hwDeviceExtension->TrappedValidatorData[0].Data =
        !          4541:                 (ULONG) (IND_SYNC_RESET + (START_SYNC_RESET_VALUE << 8));
        !          4542: 
        !          4543:     } else {
        !          4544: 
        !          4545:         //
        !          4546:         // Nothing trapped.
        !          4547:         // Lets check is the IO is trying to do something that would require
        !          4548:         // us to stop trapping
        !          4549:         //
        !          4550: 
        !          4551:         if (AccessMode & EMULATOR_WRITE_ACCESS) {
        !          4552: 
        !          4553:             //
        !          4554:             // Make sure Bit 3 of the Miscelaneous register is always 0.
        !          4555:             // If it is 1 it could select a non-existant clock, and kill the
        !          4556:             // system
        !          4557:             //
        !          4558: 
        !          4559:             if (Port == MISC_OUTPUT_REG_WRITE_PORT) {
        !          4560: 
        !          4561:                 temp = VideoPortReadPortUchar(hwDeviceExtension->IOAddress +
        !          4562:                                                   SEQ_ADDRESS_PORT);
        !          4563: 
        !          4564:                 VideoPortWritePortUshort((PUSHORT) (hwDeviceExtension->IOAddress +
        !          4565:                                              SEQ_ADDRESS_PORT),
        !          4566:                                          (USHORT) (IND_SYNC_RESET +
        !          4567:                                              (START_SYNC_RESET_VALUE << 8)));
        !          4568: 
        !          4569:                 VideoPortWritePortUchar(hwDeviceExtension->IOAddress + Port,
        !          4570:                                          (UCHAR) (*Data & 0xF7) );
        !          4571: 
        !          4572:                 VideoPortWritePortUshort((PUSHORT) (hwDeviceExtension->IOAddress +
        !          4573:                                              SEQ_ADDRESS_PORT),
        !          4574:                                          (USHORT) (IND_SYNC_RESET +
        !          4575:                                              (END_SYNC_RESET_VALUE << 8)));
        !          4576: 
        !          4577:                 VideoPortWritePortUchar(hwDeviceExtension->IOAddress +
        !          4578:                                             SEQ_ADDRESS_PORT,
        !          4579:                                         temp);
        !          4580: 
        !          4581:                 return NO_ERROR;
        !          4582: 
        !          4583:             }
        !          4584: 
        !          4585:             //
        !          4586:             // If we get an access to the sequencer register, start trapping.
        !          4587:             //
        !          4588: 
        !          4589:             if ( (Port == SEQ_DATA_PORT) &&
        !          4590:                  ((*Data & END_SYNC_RESET_VALUE) != END_SYNC_RESET_VALUE) &&
        !          4591:                  (VideoPortReadPortUchar(hwDeviceExtension->IOAddress +
        !          4592:                                          SEQ_ADDRESS_PORT) == IND_SYNC_RESET)) {
        !          4593: 
        !          4594:                 VideoPortSetTrappedEmulatorPorts(hwDeviceExtension,
        !          4595:                                                  NUM_FULL_VGA_VALIDATOR_ACCESS_RANGE,
        !          4596:                                                  FullVgaValidatorAccessRange);
        !          4597: 
        !          4598:                 hwDeviceExtension->TrappedValidatorCount = 1;
        !          4599:                 hwDeviceExtension->TrappedValidatorData[0].Port = Port;
        !          4600:                 hwDeviceExtension->TrappedValidatorData[0].AccessType =
        !          4601:                     VGA_VALIDATOR_UCHAR_ACCESS;
        !          4602: 
        !          4603:                 hwDeviceExtension->TrappedValidatorData[0].Data = *Data;
        !          4604: 
        !          4605:                 //
        !          4606:                 // Start keeping track of the state of the sequencer port.
        !          4607:                 //
        !          4608: 
        !          4609:                 hwDeviceExtension->SequencerAddressValue = IND_SYNC_RESET;
        !          4610: 
        !          4611:             } else {
        !          4612: 
        !          4613:                 VideoPortWritePortUchar(hwDeviceExtension->IOAddress + Port,
        !          4614:                                         *Data);
        !          4615: 
        !          4616:             }
        !          4617: 
        !          4618:         } else {
        !          4619: 
        !          4620:             *Data = VideoPortReadPortUchar(hwDeviceExtension->IOAddress + Port);
        !          4621: 
        !          4622:         }
        !          4623:     }
        !          4624: 
        !          4625:     return NO_ERROR;
        !          4626: 
        !          4627: } // end VgaValidatorUcharEntry()
        !          4628: 
        !          4629: VP_STATUS
        !          4630: VgaValidatorUshortEntry(
        !          4631:     ULONG Context,
        !          4632:     ULONG Port,
        !          4633:     UCHAR AccessMode,
        !          4634:     PUSHORT Data
        !          4635:     )
        !          4636: 
        !          4637: /*++
        !          4638: 
        !          4639: Routine Description:
        !          4640: 
        !          4641:     Entry point into the validator for word I/O operations.
        !          4642: 
        !          4643:     The entry point will be called whenever a byte operation was performed
        !          4644:     by a DOS application on one of the specified Video ports. The kernel
        !          4645:     emulator will forward these requests.
        !          4646: 
        !          4647: Arguments:
        !          4648: 
        !          4649:     Context - Context value that is passed to each call made to the validator
        !          4650:         function. This is the value the miniport driver specified in the
        !          4651:         MiniportConfigInfo->EmulatorAccessEntriesContext.
        !          4652: 
        !          4653:     Port - Port on which the operation is to be performed.
        !          4654: 
        !          4655:     AccessMode - Determines if it is a read or write operation.
        !          4656: 
        !          4657:     Data - Pointer to a variable containing the data to be written or a
        !          4658:         variable into which the read data should be stored.
        !          4659: 
        !          4660: Return Value:
        !          4661: 
        !          4662:     NO_ERROR.
        !          4663: 
        !          4664: --*/
        !          4665: 
        !          4666: {
        !          4667: 
        !          4668:     PHW_DEVICE_EXTENSION hwDeviceExtension = (PHW_DEVICE_EXTENSION) Context;
        !          4669:     ULONG endEmulation;
        !          4670:     UCHAR temp;
        !          4671: 
        !          4672:     Port -= VGA_BASE_IO_PORT;
        !          4673: 
        !          4674:     if (hwDeviceExtension->TrappedValidatorCount) {
        !          4675: 
        !          4676:         //
        !          4677:         // If we are processing a WRITE instruction, then store it in the
        !          4678:         // playback buffer. If the buffer is full, then play it back right
        !          4679:         // away, end sync reset and reinitialize the buffer with a sync
        !          4680:         // reset instruction.
        !          4681:         //
        !          4682:         // If we have a READ, we must flush the buffer (which has the side
        !          4683:         // effect of starting SyncReset), perform the read operation, stop
        !          4684:         // sync reset, and put back a sync reset instruction in the buffer
        !          4685:         // so we can go on appropriately
        !          4686:         //
        !          4687: 
        !          4688:         if (AccessMode & EMULATOR_WRITE_ACCESS) {
        !          4689: 
        !          4690:             //
        !          4691:             // Make sure Bit 3 of the Miscellaneous register is always 0.
        !          4692:             // If it is 1 it could select a non-existent clock, and kill the
        !          4693:             // system
        !          4694:             //
        !          4695: 
        !          4696:             if (Port == MISC_OUTPUT_REG_WRITE_PORT) {
        !          4697: 
        !          4698:                 *Data &= 0xFFF7;
        !          4699: 
        !          4700:             }
        !          4701: 
        !          4702:             hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4703:                 TrappedValidatorCount].Port = Port;
        !          4704: 
        !          4705:             hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4706:                 TrappedValidatorCount].AccessType = VGA_VALIDATOR_USHORT_ACCESS;
        !          4707: 
        !          4708:             hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4709:                 TrappedValidatorCount].Data = *Data;
        !          4710: 
        !          4711:             hwDeviceExtension->TrappedValidatorCount++;
        !          4712: 
        !          4713:             //
        !          4714:             // Check to see if this instruction was ending sync reset.
        !          4715:             // If it did, we must flush the buffer and reset the trapped
        !          4716:             // IO ports to the minimal set.
        !          4717:             //
        !          4718: 
        !          4719:             if (Port == SEQ_ADDRESS_PORT) {
        !          4720: 
        !          4721:                 //
        !          4722:                 // If we are accessing the seq address port, keep track of its
        !          4723:                 // value
        !          4724:                 //
        !          4725: 
        !          4726:                 hwDeviceExtension->SequencerAddressValue = (*Data & 0xFF);
        !          4727: 
        !          4728:             }
        !          4729: 
        !          4730:             if ((Port == SEQ_ADDRESS_PORT) &&
        !          4731:                 ( ((*Data >> 8) & END_SYNC_RESET_VALUE) ==
        !          4732:                    END_SYNC_RESET_VALUE) &&
        !          4733:                 (hwDeviceExtension->SequencerAddressValue == IND_SYNC_RESET)) {
        !          4734: 
        !          4735:                 endEmulation = 1;
        !          4736: 
        !          4737:             } else {
        !          4738: 
        !          4739:                 //
        !          4740:                 // If the buffer is not full, then just return right away.
        !          4741:                 //
        !          4742: 
        !          4743:                 if (hwDeviceExtension->TrappedValidatorCount <
        !          4744:                        VGA_MAX_VALIDATOR_DATA - 1) {
        !          4745: 
        !          4746:                     return NO_ERROR;
        !          4747: 
        !          4748:                 }
        !          4749: 
        !          4750:                 endEmulation = 0;
        !          4751:             }
        !          4752:         }
        !          4753: 
        !          4754:         //
        !          4755:         // We are either in a READ path or a WRITE path that caused a
        !          4756:         // a full buffer. So flush the buffer either way.
        !          4757:         //
        !          4758:         // To do this put an END_SYNC_RESET at the end since we want to make
        !          4759:         // the buffer is ended sync reset ended.
        !          4760:         //
        !          4761: 
        !          4762:         hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4763:             TrappedValidatorCount].Port = SEQ_ADDRESS_PORT;
        !          4764: 
        !          4765:         hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4766:             TrappedValidatorCount].AccessType = VGA_VALIDATOR_USHORT_ACCESS;
        !          4767: 
        !          4768:         hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4769:             TrappedValidatorCount].Data = (USHORT) (IND_SYNC_RESET +
        !          4770:                                           (END_SYNC_RESET_VALUE << 8));
        !          4771: 
        !          4772:         hwDeviceExtension->TrappedValidatorCount++;
        !          4773: 
        !          4774:         VideoPortSynchronizeExecution(hwDeviceExtension,
        !          4775:                                       VpHighPriority,
        !          4776:                                       (PMINIPORT_SYNCHRONIZE_ROUTINE)
        !          4777:                                           VgaPlaybackValidatorData,
        !          4778:                                       hwDeviceExtension);
        !          4779: 
        !          4780:         //
        !          4781:         // Write back the real value of the sequencer address port.
        !          4782:         //
        !          4783: 
        !          4784:         VideoPortWritePortUchar((PUCHAR) (hwDeviceExtension->IOAddress +
        !          4785:                                     SEQ_ADDRESS_PORT),
        !          4786:                                 (UCHAR) hwDeviceExtension->SequencerAddressValue);
        !          4787: 
        !          4788:         //
        !          4789:         // If we are in a READ path, read the data
        !          4790:         //
        !          4791: 
        !          4792:         if (AccessMode & EMULATOR_READ_ACCESS) {
        !          4793: 
        !          4794:             *Data = VideoPortReadPortUshort((PUSHORT)(hwDeviceExtension->IOAddress
        !          4795:                                                 + Port));
        !          4796: 
        !          4797:             endEmulation = 0;
        !          4798: 
        !          4799:         }
        !          4800: 
        !          4801:         //
        !          4802:         // If we are ending emulation, reset trapping to the minimal amount
        !          4803:         // and exit.
        !          4804:         //
        !          4805: 
        !          4806:         if (endEmulation) {
        !          4807: 
        !          4808:             VideoPortSetTrappedEmulatorPorts(hwDeviceExtension,
        !          4809:                                              NUM_MINIMAL_VGA_VALIDATOR_ACCESS_RANGE,
        !          4810:                                              MinimalVgaValidatorAccessRange);
        !          4811: 
        !          4812:             return NO_ERROR;
        !          4813: 
        !          4814:         }
        !          4815: 
        !          4816:         //
        !          4817:         // For both cases, put back a START_SYNC_RESET in the buffer.
        !          4818:         //
        !          4819: 
        !          4820:         hwDeviceExtension->TrappedValidatorCount = 1;
        !          4821: 
        !          4822:         hwDeviceExtension->TrappedValidatorData[0].Port = SEQ_ADDRESS_PORT;
        !          4823: 
        !          4824:         hwDeviceExtension->TrappedValidatorData[0].AccessType =
        !          4825:                 VGA_VALIDATOR_USHORT_ACCESS;
        !          4826: 
        !          4827:         hwDeviceExtension->TrappedValidatorData[0].Data =
        !          4828:                 (ULONG) (IND_SYNC_RESET + (START_SYNC_RESET_VALUE << 8));
        !          4829: 
        !          4830:     } else {
        !          4831: 
        !          4832:         //
        !          4833:         // Nothing trapped.
        !          4834:         // Lets check is the IO is trying to do something that would require
        !          4835:         // us to stop trapping
        !          4836:         //
        !          4837: 
        !          4838:         if (AccessMode & EMULATOR_WRITE_ACCESS) {
        !          4839: 
        !          4840:             //
        !          4841:             // Make sure Bit 3 of the Miscelaneous register is always 0.
        !          4842:             // If it is 1 it could select a non-existant clock, and kill the
        !          4843:             // system
        !          4844:             //
        !          4845: 
        !          4846:             if (Port == MISC_OUTPUT_REG_WRITE_PORT) {
        !          4847: 
        !          4848:                 temp = VideoPortReadPortUchar(hwDeviceExtension->IOAddress +
        !          4849:                                                   SEQ_ADDRESS_PORT);
        !          4850: 
        !          4851:                 VideoPortWritePortUshort((PUSHORT) (hwDeviceExtension->IOAddress +
        !          4852:                                              SEQ_ADDRESS_PORT),
        !          4853:                                          (USHORT) (IND_SYNC_RESET +
        !          4854:                                              (START_SYNC_RESET_VALUE << 8)));
        !          4855: 
        !          4856:                 VideoPortWritePortUshort((PUSHORT) (hwDeviceExtension->IOAddress +
        !          4857:                                              (ULONG)Port),
        !          4858:                                          (USHORT) (*Data & 0xFFF7) );
        !          4859: 
        !          4860:                 VideoPortWritePortUshort((PUSHORT) (hwDeviceExtension->IOAddress +
        !          4861:                                              SEQ_ADDRESS_PORT),
        !          4862:                                          (USHORT) (IND_SYNC_RESET +
        !          4863:                                              (END_SYNC_RESET_VALUE << 8)));
        !          4864: 
        !          4865:                 VideoPortWritePortUchar(hwDeviceExtension->IOAddress + SEQ_ADDRESS_PORT,
        !          4866:                                         temp);
        !          4867: 
        !          4868:                 return NO_ERROR;
        !          4869: 
        !          4870:             }
        !          4871: 
        !          4872:             if ( (Port == SEQ_ADDRESS_PORT) &&
        !          4873:                  (((*Data>> 8) & END_SYNC_RESET_VALUE) != END_SYNC_RESET_VALUE) &&
        !          4874:                  ((*Data & 0xFF) == IND_SYNC_RESET)) {
        !          4875: 
        !          4876:                 VideoPortSetTrappedEmulatorPorts(hwDeviceExtension,
        !          4877:                                                  NUM_FULL_VGA_VALIDATOR_ACCESS_RANGE,
        !          4878:                                                  FullVgaValidatorAccessRange);
        !          4879: 
        !          4880:                 hwDeviceExtension->TrappedValidatorCount = 1;
        !          4881:                 hwDeviceExtension->TrappedValidatorData[0].Port = Port;
        !          4882:                 hwDeviceExtension->TrappedValidatorData[0].AccessType =
        !          4883:                     VGA_VALIDATOR_USHORT_ACCESS;
        !          4884: 
        !          4885:                 hwDeviceExtension->TrappedValidatorData[0].Data = *Data;
        !          4886: 
        !          4887:                 //
        !          4888:                 // Start keeping track of the state of the sequencer port.
        !          4889:                 //
        !          4890: 
        !          4891:                 hwDeviceExtension->SequencerAddressValue = IND_SYNC_RESET;
        !          4892: 
        !          4893:             } else {
        !          4894: 
        !          4895:                 VideoPortWritePortUshort((PUSHORT)(hwDeviceExtension->IOAddress +
        !          4896:                                              Port),
        !          4897:                                          *Data);
        !          4898: 
        !          4899:             }
        !          4900: 
        !          4901:         } else {
        !          4902: 
        !          4903:             *Data = VideoPortReadPortUshort((PUSHORT)(hwDeviceExtension->IOAddress +
        !          4904:                                             Port));
        !          4905: 
        !          4906:         }
        !          4907:     }
        !          4908: 
        !          4909:     return NO_ERROR;
        !          4910: 
        !          4911: } // end VgaValidatorUshortEntry()
        !          4912: 
        !          4913: VP_STATUS
        !          4914: VgaValidatorUlongEntry(
        !          4915:     ULONG Context,
        !          4916:     ULONG Port,
        !          4917:     UCHAR AccessMode,
        !          4918:     PULONG Data
        !          4919:     )
        !          4920: 
        !          4921: /*++
        !          4922: 
        !          4923: Routine Description:
        !          4924: 
        !          4925:     Entry point into the validator for dword I/O operations.
        !          4926: 
        !          4927:     The entry point will be called whenever a byte operation was performed
        !          4928:     by a DOS application on one of the specified Video ports. The kernel
        !          4929:     emulator will forward these requests.
        !          4930: 
        !          4931: Arguments:
        !          4932: 
        !          4933:     Context - Context value that is passed to each call made to the validator
        !          4934:         function. This is the value the miniport driver specified in the
        !          4935:         MiniportConfigInfo->EmulatorAccessEntriesContext.
        !          4936: 
        !          4937:     Port - Port on which the operation is to be performed.
        !          4938: 
        !          4939:     AccessMode - Determines if it is a read or write operation.
        !          4940: 
        !          4941:     Data - Pointer to a variable containing the data to be written or a
        !          4942:         variable into which the read data should be stored.
        !          4943: 
        !          4944: Return Value:
        !          4945: 
        !          4946:     NO_ERROR.
        !          4947: 
        !          4948: --*/
        !          4949: 
        !          4950: {
        !          4951: 
        !          4952:     PHW_DEVICE_EXTENSION hwDeviceExtension = (PHW_DEVICE_EXTENSION) Context;
        !          4953:     ULONG endEmulation;
        !          4954:     UCHAR temp;
        !          4955: 
        !          4956:     Port -= VGA_BASE_IO_PORT;
        !          4957: 
        !          4958:     if (hwDeviceExtension->TrappedValidatorCount) {
        !          4959: 
        !          4960:         //
        !          4961:         // If we are processing a WRITE instruction, then store it in the
        !          4962:         // playback buffer. If the buffer is full, then play it back right
        !          4963:         // away, end sync reset and reinitialize the buffer with a sync
        !          4964:         // reset instruction.
        !          4965:         //
        !          4966:         // If we have a READ, we must flush the buffer (which has the side
        !          4967:         // effect of starting SyncReset), perform the read operation, stop
        !          4968:         // sync reset, and put back a sync reset instruction in the buffer
        !          4969:         // so we can go on appropriately
        !          4970:         //
        !          4971: 
        !          4972:         if (AccessMode & EMULATOR_WRITE_ACCESS) {
        !          4973: 
        !          4974:             //
        !          4975:             // Make sure Bit 3 of the Miscellaneous register is always 0.
        !          4976:             // If it is 1 it could select a non-existent clock, and kill the
        !          4977:             // system
        !          4978:             //
        !          4979: 
        !          4980:             if (Port == MISC_OUTPUT_REG_WRITE_PORT) {
        !          4981: 
        !          4982:                 *Data &= 0xFFFFFFF7;
        !          4983: 
        !          4984:             }
        !          4985: 
        !          4986:             hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4987:                 TrappedValidatorCount].Port = Port;
        !          4988: 
        !          4989:             hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4990:                 TrappedValidatorCount].AccessType = VGA_VALIDATOR_ULONG_ACCESS;
        !          4991: 
        !          4992:             hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          4993:                 TrappedValidatorCount].Data = *Data;
        !          4994: 
        !          4995:             hwDeviceExtension->TrappedValidatorCount++;
        !          4996: 
        !          4997:             //
        !          4998:             // Check to see if this instruction was ending sync reset.
        !          4999:             // If it did, we must flush the buffer and reset the trapped
        !          5000:             // IO ports to the minimal set.
        !          5001:             //
        !          5002: 
        !          5003:             if (Port == SEQ_ADDRESS_PORT) {
        !          5004: 
        !          5005:                 //
        !          5006:                 // If we are accessing the seq address port, keep track of its
        !          5007:                 // value
        !          5008:                 //
        !          5009: 
        !          5010:                 hwDeviceExtension->SequencerAddressValue = (*Data & 0xFF);
        !          5011: 
        !          5012:             }
        !          5013: 
        !          5014:             if ((Port == SEQ_ADDRESS_PORT) &&
        !          5015:                 ( ((*Data >> 8) & END_SYNC_RESET_VALUE) ==
        !          5016:                    END_SYNC_RESET_VALUE) &&
        !          5017:                 (hwDeviceExtension->SequencerAddressValue == IND_SYNC_RESET)) {
        !          5018: 
        !          5019:                 endEmulation = 1;
        !          5020: 
        !          5021:             } else {
        !          5022: 
        !          5023:                 //
        !          5024:                 // If the buffer is not full, then just return right away.
        !          5025:                 //
        !          5026: 
        !          5027:                 if (hwDeviceExtension->TrappedValidatorCount <
        !          5028:                        VGA_MAX_VALIDATOR_DATA - 1) {
        !          5029: 
        !          5030:                     return NO_ERROR;
        !          5031: 
        !          5032:                 }
        !          5033: 
        !          5034:                 endEmulation = 0;
        !          5035:             }
        !          5036:         }
        !          5037: 
        !          5038:         //
        !          5039:         // We are either in a READ path or a WRITE path that caused a
        !          5040:         // a full buffer. So flush the buffer either way.
        !          5041:         //
        !          5042:         // To do this put an END_SYNC_RESET at the end since we want to make
        !          5043:         // the buffer is ended sync reset ended.
        !          5044:         //
        !          5045: 
        !          5046:         hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          5047:             TrappedValidatorCount].Port = SEQ_ADDRESS_PORT;
        !          5048: 
        !          5049:         hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          5050:             TrappedValidatorCount].AccessType = VGA_VALIDATOR_USHORT_ACCESS;
        !          5051: 
        !          5052:         hwDeviceExtension->TrappedValidatorData[hwDeviceExtension->
        !          5053:             TrappedValidatorCount].Data = (USHORT) (IND_SYNC_RESET +
        !          5054:                                           (END_SYNC_RESET_VALUE << 8));
        !          5055: 
        !          5056:         hwDeviceExtension->TrappedValidatorCount++;
        !          5057: 
        !          5058:         VideoPortSynchronizeExecution(hwDeviceExtension,
        !          5059:                                       VpHighPriority,
        !          5060:                                       (PMINIPORT_SYNCHRONIZE_ROUTINE)
        !          5061:                                           VgaPlaybackValidatorData,
        !          5062:                                       hwDeviceExtension);
        !          5063: 
        !          5064:         //
        !          5065:         // Write back the real value of the sequencer address port.
        !          5066:         //
        !          5067: 
        !          5068:         VideoPortWritePortUchar(hwDeviceExtension->IOAddress +
        !          5069:                                     SEQ_ADDRESS_PORT,
        !          5070:                                 (UCHAR) hwDeviceExtension->SequencerAddressValue);
        !          5071: 
        !          5072:         //
        !          5073:         // If we are in a READ path, read the data
        !          5074:         //
        !          5075: 
        !          5076:         if (AccessMode & EMULATOR_READ_ACCESS) {
        !          5077: 
        !          5078:             *Data = VideoPortReadPortUlong((PULONG) (hwDeviceExtension->IOAddress +
        !          5079:                                                Port));
        !          5080: 
        !          5081:             endEmulation = 0;
        !          5082: 
        !          5083:         }
        !          5084: 
        !          5085:         //
        !          5086:         // If we are ending emulation, reset trapping to the minimal amount
        !          5087:         // and exit.
        !          5088:         //
        !          5089: 
        !          5090:         if (endEmulation) {
        !          5091: 
        !          5092:             VideoPortSetTrappedEmulatorPorts(hwDeviceExtension,
        !          5093:                                              NUM_MINIMAL_VGA_VALIDATOR_ACCESS_RANGE,
        !          5094:                                              MinimalVgaValidatorAccessRange);
        !          5095: 
        !          5096:             return NO_ERROR;
        !          5097: 
        !          5098:         }
        !          5099: 
        !          5100:         //
        !          5101:         // For both cases, put back a START_SYNC_RESET in the buffer.
        !          5102:         //
        !          5103: 
        !          5104:         hwDeviceExtension->TrappedValidatorCount = 1;
        !          5105: 
        !          5106:         hwDeviceExtension->TrappedValidatorData[0].Port = SEQ_ADDRESS_PORT;
        !          5107: 
        !          5108:         hwDeviceExtension->TrappedValidatorData[0].AccessType =
        !          5109:                 VGA_VALIDATOR_USHORT_ACCESS;
        !          5110: 
        !          5111:         hwDeviceExtension->TrappedValidatorData[0].Data =
        !          5112:                 (ULONG) (IND_SYNC_RESET + (START_SYNC_RESET_VALUE << 8));
        !          5113: 
        !          5114:     } else {
        !          5115: 
        !          5116:         //
        !          5117:         // Nothing trapped.
        !          5118:         // Lets check is the IO is trying to do something that would require
        !          5119:         // us to stop trapping
        !          5120:         //
        !          5121: 
        !          5122:         if (AccessMode & EMULATOR_WRITE_ACCESS) {
        !          5123: 
        !          5124:             //
        !          5125:             // Make sure Bit 3 of the Miscelaneous register is always 0.
        !          5126:             // If it is 1 it could select a non-existant clock, and kill the
        !          5127:             // system
        !          5128:             //
        !          5129: 
        !          5130:             if (Port == MISC_OUTPUT_REG_WRITE_PORT) {
        !          5131: 
        !          5132:                 temp = VideoPortReadPortUchar(hwDeviceExtension->IOAddress +
        !          5133:                                                   SEQ_ADDRESS_PORT);
        !          5134: 
        !          5135:                 VideoPortWritePortUshort((PUSHORT) (hwDeviceExtension->IOAddress +
        !          5136:                                              SEQ_ADDRESS_PORT),
        !          5137:                                          (USHORT) (IND_SYNC_RESET +
        !          5138:                                              (START_SYNC_RESET_VALUE << 8)));
        !          5139: 
        !          5140:                 VideoPortWritePortUlong((PULONG) (hwDeviceExtension->IOAddress +
        !          5141:                                              Port),
        !          5142:                                          (ULONG) (*Data & 0xFFFFFFF7) );
        !          5143: 
        !          5144:                 VideoPortWritePortUshort((PUSHORT) (hwDeviceExtension->IOAddress +
        !          5145:                                              SEQ_ADDRESS_PORT),
        !          5146:                                          (USHORT) (IND_SYNC_RESET +
        !          5147:                                              (END_SYNC_RESET_VALUE << 8)));
        !          5148: 
        !          5149:                 VideoPortWritePortUchar(hwDeviceExtension->IOAddress + SEQ_ADDRESS_PORT,
        !          5150:                                         temp);
        !          5151: 
        !          5152:                 return NO_ERROR;
        !          5153: 
        !          5154:             }
        !          5155: 
        !          5156:             if ( (Port == SEQ_ADDRESS_PORT) &&
        !          5157:                  (((*Data>> 8) & END_SYNC_RESET_VALUE) != END_SYNC_RESET_VALUE) &&
        !          5158:                  ((*Data & 0xFF) == IND_SYNC_RESET)) {
        !          5159: 
        !          5160:                 VideoPortSetTrappedEmulatorPorts(hwDeviceExtension,
        !          5161:                                                  NUM_FULL_VGA_VALIDATOR_ACCESS_RANGE,
        !          5162:                                                  FullVgaValidatorAccessRange);
        !          5163: 
        !          5164:                 hwDeviceExtension->TrappedValidatorCount = 1;
        !          5165:                 hwDeviceExtension->TrappedValidatorData[0].Port = Port;
        !          5166:                 hwDeviceExtension->TrappedValidatorData[0].AccessType =
        !          5167:                     VGA_VALIDATOR_ULONG_ACCESS;
        !          5168: 
        !          5169:                 hwDeviceExtension->TrappedValidatorData[0].Data = *Data;
        !          5170: 
        !          5171:                 //
        !          5172:                 // Start keeping track of the state of the sequencer port.
        !          5173:                 //
        !          5174: 
        !          5175:                 hwDeviceExtension->SequencerAddressValue = IND_SYNC_RESET;
        !          5176: 
        !          5177:             } else {
        !          5178: 
        !          5179:                 VideoPortWritePortUlong((PULONG) (hwDeviceExtension->IOAddress +
        !          5180:                                             Port),
        !          5181:                                         *Data);
        !          5182: 
        !          5183:             }
        !          5184: 
        !          5185:         } else {
        !          5186: 
        !          5187:             *Data = VideoPortReadPortUlong((PULONG) (hwDeviceExtension->IOAddress +
        !          5188:                                                Port));
        !          5189: 
        !          5190:         }
        !          5191:     }
        !          5192: 
        !          5193:     return NO_ERROR;
        !          5194: 
        !          5195: } // end VgaValidatorUlongEntry()
        !          5196: 
        !          5197: 
        !          5198: BOOLEAN
        !          5199: VgaPlaybackValidatorData(
        !          5200:     PVOID Context
        !          5201:     )
        !          5202: 
        !          5203: /*++
        !          5204: 
        !          5205: Routine Description:
        !          5206: 
        !          5207:     Performs all the DOS apps IO port accesses that were trapped by the
        !          5208:     validator. Only IO accesses that can be processed are WRITEs
        !          5209: 
        !          5210:     The number of outstanding IO access in deviceExtension is set to
        !          5211:     zero as a side effect.
        !          5212: 
        !          5213:     This function must be called via a call to VideoPortSynchronizeRoutine.
        !          5214: 
        !          5215: Arguments:
        !          5216: 
        !          5217:     Context - Context parameter passed to the synchronized routine.
        !          5218:         Must be a pointer to the miniport driver's device extension.
        !          5219: 
        !          5220: Return Value:
        !          5221: 
        !          5222:     TRUE.
        !          5223: 
        !          5224: --*/
        !          5225: 
        !          5226: {
        !          5227:     PHW_DEVICE_EXTENSION hwDeviceExtension = Context;
        !          5228:     ULONG ioBaseAddress = (ULONG) hwDeviceExtension->IOAddress;
        !          5229:     UCHAR i;
        !          5230:     PVGA_VALIDATOR_DATA validatorData = hwDeviceExtension->TrappedValidatorData;
        !          5231: 
        !          5232:     //
        !          5233:     // Loop through the array of data and do instructions one by one.
        !          5234:     //
        !          5235: 
        !          5236:     for (i = 0; i < hwDeviceExtension->TrappedValidatorCount;
        !          5237:          i++, validatorData++) {
        !          5238: 
        !          5239:         //
        !          5240:         // Calculate base address first
        !          5241:         //
        !          5242: 
        !          5243:         ioBaseAddress = (ULONG)hwDeviceExtension->IOAddress +
        !          5244:                             validatorData->Port;
        !          5245: 
        !          5246: 
        !          5247:         //
        !          5248:         // This is a write operation. We will automatically stop when the
        !          5249:         // buffer is empty.
        !          5250:         //
        !          5251: 
        !          5252:         switch (validatorData->AccessType) {
        !          5253: 
        !          5254:         case VGA_VALIDATOR_UCHAR_ACCESS :
        !          5255: 
        !          5256:             VideoPortWritePortUchar((PUCHAR)ioBaseAddress,
        !          5257:                                     (UCHAR) validatorData->Data);
        !          5258: 
        !          5259:             break;
        !          5260: 
        !          5261:         case VGA_VALIDATOR_USHORT_ACCESS :
        !          5262: 
        !          5263:             VideoPortWritePortUshort((PUSHORT)ioBaseAddress,
        !          5264:                                      (USHORT) validatorData->Data);
        !          5265: 
        !          5266:             break;
        !          5267: 
        !          5268:         case VGA_VALIDATOR_ULONG_ACCESS :
        !          5269: 
        !          5270:             VideoPortWritePortUlong((PULONG)ioBaseAddress,
        !          5271:                                     (ULONG) validatorData->Data);
        !          5272: 
        !          5273:             break;
        !          5274: 
        !          5275:         default:
        !          5276: 
        !          5277:             VideoDebugPrint((0, "InvalidValidatorAccessType\n" ));
        !          5278: 
        !          5279:         }
        !          5280:     }
        !          5281: 
        !          5282:     hwDeviceExtension->TrappedValidatorCount = 0;
        !          5283: 
        !          5284:     return TRUE;
        !          5285: 
        !          5286: } // end VgaPlaybackValidatorData()

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.