home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 April (Special) / Chip-Special_1997-04_cd.bin / trident / ux64-win / ux64-win.exe / VAFCREAD.TXT < prev    next >
Text File  |  1995-11-10  |  7KB  |  189 lines
  1. README.TXT 
  2.  
  3. NOTES ON VAFC driver
  4. ====================
  5. tri_afc.drv is a Windows installable driver. It can be installed or  
  6. uninstalled by using Windows Control Panel.    
  7.  
  8. After VAFC driver is installed, the vesa.afc= line is added into the 
  9. [drivers] section of SYSTEM.INI as follows:
  10.     .
  11.     .
  12.     .
  13.     [drivers]
  14.     vesa.afc=tri_vafc.drv
  15.     .
  16.     .
  17.     .
  18. and the line tri_vafc.drv=. . . is added in the [drivers.desc] of CONTROL.INI 
  19. as follows:        
  20.     .
  21.     .
  22.     .
  23.     [drivers.desc]
  24.     tri_vafc.drv=Trident VAFC Driver
  25.     .
  26.     .
  27.     .
  28.  
  29.  
  30.  
  31. The VAFC distribute disk contains the following files:
  32.  
  33.     tri_vafc.drv
  34.     vesa_afc.h
  35.     tri_afc.h
  36.     readme.txt      
  37.  
  38.  
  39.  
  40. To access VAFC driver functions, open VAFC driver first, then use
  41. VAFC functions, and close the driver after the application completely 
  42. finishes the access to VAFC functions.
  43.  
  44. To open VAFC driver, call OpenDriver function. The syntex of OpenDriver
  45. is as follows:
  46.         
  47.     HDRVR OpenDriver(lpDriverName, lpSectionName, lParam)
  48.     LPCSTR lpDriverName;    /* address of driver name       */
  49.     LPCSTR lpSectionName;   /* address of .INI file section name    */
  50.     LPARAM lParam;                  /* address of driver-specific information       */
  51.     
  52. An example is:
  53.  
  54.     HDRVR   far     hDriver = NULL;         /* the handle of the driver */  
  55.     hDriver = OpenDriver((LPSTR)"vesa.afc", NULL, 0L)
  56.  
  57. To close VAFC driver, call CloseDriver. The syntex of CloseDriver is 
  58. as follows:
  59.  
  60.     LRESULT CloseDriver(hdrvr, lParam1, lParam2)
  61.     HDRVR hdrvr;                    /* handle of installable driver */
  62.     LPARAM lParam1;                 /* driver-specific data */
  63.     LPARAM lParam2;                 /* driver-specific data */ 
  64.     
  65. An example is:
  66.  
  67.     CloseDriver(hriver, 0L, 0L);
  68.     
  69.     
  70. The VAFC functions (and their corresponding messages) provided by 
  71. Trident VAFC driver are listed below:   
  72.  
  73. // Gets the vendor and device information for the VAFC graphics subsystem.
  74. BOOL STD_GET_DEVCAPS(LPVESA_DEVICECAPS);        // DRV_VAFC_GET_DEVCAPS
  75.  
  76. // Gets the current color space format of the connector
  77. BOOL STD_GET_COLOR_SPACE(DWORD far *);          // DRV_VAFC_GET_COLOR_SPACE
  78.  
  79. // Sets the color space format of the connector
  80. BOOL STD_SET_COLOR_SPACE(DWORD);                        // DRV_VAFC_SET_COLOR_SPACE
  81.  
  82. // Gets the current bus transfer width of the connctor
  83. BOOL STD_GET_BUS_WIDTH(DWORD far *);            // DRV_VAFC_GET_BUS_WIDTH
  84.  
  85. // sets the bus transfer width of the connector
  86. BOOL STD_SET_BUS_WIDTH(DWORD);                          // DRV_VAFC_SET_BUS_WIDTH                 
  87.  
  88. // Gets the current data mode of the connctor
  89. BOOL STD_GET_DATA_MODE(DWORD far *);            // DRV_VAFC_GET_DATA_MODE         
  90.  
  91. // Sets the data mode of the connector
  92. BOOL STD_SET_DATA_MODE(DWORD);                          // DRV_VAFC_SET_DATA_MODE        
  93.  
  94. // Gets the current clock mode of the connector
  95. BOOL STD_GET_CLOCK_MODE(DWORD far *);           // DRV_VAFC_GET_CLOCK_MODE
  96.  
  97. // Sets the clock mode of the connector
  98. BOOL STD_SET_CLOCK_MODE(DWORD);                         // DRV_VAFC_SET_CLOCK_MODE        
  99.  
  100. //Gets the overlay color information currently used by the graphics subsystem
  101. BOOL STD_GET_OVERLAY_COLOR_INFO(LPVAFCOVERLAY_CONTROLS, DWORD);
  102.                                     // DRV_VAFC_GET_OVERLAY_COLOR_INFO              
  103.  
  104. // Sets the overlay color information used by the graphics subsystem
  105. BOOL STD_SET_OVERLAY_COLOR_INFO(LPVAFCOVERLAY_CONTROLS, DWORD);
  106.                                     // DRV_VAFC_SET_OVERLAY_COLOR_INFO
  107.                                     
  108. // Gets the window coordinates for the display window, currently not supported                                                                    
  109. BOOL STD_GET_WINDOW_RECT(LPRECT);       // DRV_VAFC_GET_WINDOW_RECT                    
  110.  
  111. // Sets the window coordinates for the displat window, currently not supported
  112. BOOL STD_SET_WINDOW_RECT(LPRECT);       // DRV_VAFC_SET_WINDOW_RECT                    
  113.  
  114. // Gets some miscellaneous graphics information from the graphics subsystem 
  115. // based on the current mode of graphics operation, currently not supported
  116. BOOL STD_GET_GRAPHICS_INFO(LPVAFCGRAPHICS_INFO);
  117.                                     // DRV_VAFC_GET_GRAPHICS_INFO  
  118.  
  119. // Gets all available video color spaces from the VAFC driver
  120. BOOL STD_QUERY_COLOR_SPACES(DWORD far *, DWORD);
  121.                                     // DRV_VAFC_QUERY_COLOR_SPACES
  122.  
  123. // Gets the current extended mode parameters, currently not supported
  124. BOOL STD_GET_EXTENDED_SETUP(LPVAFCEXTENDED_INFO);
  125.                                     // DRV_VAFC_GET_EXTENDED_SETUP
  126.  
  127. // Sets the extended mode parameters, currently not supported
  128. BOOL STD_SET_EXTENDED_SETUP(LPVAFCEXTENDED_INFO);
  129.                                     // DRV_VAFC_SET_EXTENDED_SETUP
  130.  
  131. // Gets the preferred setup of the VAFC subsystem for the graphics subsystem,
  132. // currently not supported
  133. BOOL STD_GET_PREFERRED_SETUP(LPVAFCPREFERRED_PARAMETERS);                   
  134.                     // DRV_VAFC_GET_PREFERRED_SETUP
  135.                     
  136. // Gets the last error code and clears it
  137. BOOL STD_GET_ERROR_CODE(DWORD far *);   // DRV_VAFC_GET_ERROR
  138.  
  139. The Trident AFC functions (and their corresponding messages) provided by 
  140. Trident VAFC driver are listed below:   
  141.  
  142. // Gets Video overlay key type
  143. BOOL    TRI_GET_KEY_TYPE(DWORD far *);  // DRV_VAFC_GET_KEY_TYPE
  144.  
  145. // Sets Video overlay key type
  146. BOOL    TRI_SET_KEY_TYPE(DWORD);                // DRV_VAFC_SET_KEY_TYPE
  147.  
  148. // Gets Pixel data signal delay adjustment
  149. BOOL    TRI_GET_PCLK_DELAY(DWORD far *);// DRV_VAFC_GET_PCLK_DELAY
  150.  
  151. // Sets Pixel data signal delay adjustment      
  152. BOOL    TRI_SET_PCLK_DELAY(DWORD);              // DRV_VAFC_SET_PCLK_DELAY  
  153.  
  154. // Gets AFC control status
  155. BOOL    TRI_GET_CLK(LPVAFCCLK_CONTROLS, DWORD); // DRV_VAFC_GET_CLK
  156.  
  157. // Sets AFC control status
  158. BOOL    TRI_SET_CLK(LPVAFCCLK_CONTROLS, DWORD); // DRV_VAFC_SET_CLK
  159.  
  160. // Gets HSYNC Delay
  161. BOOL    TRI_GET_SYNC_AFCPROS(DWORD far *);              // DRV_VAFC_GET_SYNC_AFCPROS
  162.  
  163. // Sets HSYNC Delay
  164. BOOL    TRI_SET_SYNC_AFCPROS(DWORD);                    // DRV_VAFC_SET_SYNC_AFCPROS
  165.  
  166.  
  167.  
  168. All these VAFC and Trident AFC can be invoked by send some message to VAFC 
  169. driver. The syntex of SendDriverMessage is as follows:
  170.  
  171.     LRESULT SendDriverMessage(hdrvr, msg, lParam1, lParam2)
  172.     HDRVR hdrvr;    /* handle of installable driver */
  173.     UINT msg;       /* message      */
  174.     LPARAM lParam1; /* first message parameter      */
  175.     LPARAM lParam2; /* second message parameter     */
  176.  
  177.  
  178. Here are some examples:
  179.     SendDriverMessage(hDriver, DRV_VAFC_GET_DEVCAPS, 
  180.         (LPARAM)(LPVESA_DEVICECAPS)&device_caps, 0L);   
  181.  
  182.     SendDriverMessage(hDriver, DRV_VAFC_SET_COLOR_SPACE, 
  183.         (LPARAM)color_space, 0L); 
  184.  
  185.     SendDriverMessage(hDriver, DRV_VAFC_GET_COLOR_SPACE, 
  186.         (LPARAM)(DWORD far *)&color_space, 0L);         
  187.  
  188.     SendDriverMessage(hDriver, DRV_VAFC_GET_ERROR, (LPARAM)&dWError, 0L);
  189.