wine/dlls/winspool info.c

[Alexandre Julliard]

ChangeSet ID:	21499
CVSROOT:	/opt/cvs-commit
Module name:	wine
Changes by:	julliard at winehq.org	2005/11/28 14:04:01

Modified files:
	dlls/winspool  : info.c 

Log message:
	Detlef Riekenberg <wine.dev at web.de>
	Documentation added for GetPrinterDriverDirectoryW + A.

Patch: http://cvs.winehq.org/patch.py?id=21499

Old revision  New revision  Changes     Path
 1.130         1.131         +37 -0      wine/dlls/winspool/info.c

Index: wine/dlls/winspool/info.c
diff -u -p wine/dlls/winspool/info.c:1.130 wine/dlls/winspool/info.c:1.131
--- wine/dlls/winspool/info.c:1.130	28 Nov 2005 20: 4: 1 -0000
+++ wine/dlls/winspool/info.c	28 Nov 2005 20: 4: 1 -0000
@@ -3228,6 +3228,35 @@ BOOL WINAPI GetPrinterDriverW(HANDLE hPr
 
 /*****************************************************************************
  *       GetPrinterDriverDirectoryW  [WINSPOOL.@]
+ *
+ * Return the PATH for the Printer-Drivers (UNICODE)
+ *
+ * PARAMS
+ *   pName            [I] Servername (NT only) or NULL (local Computer)
+ *   pEnvironment     [I] Printing-Environment (see below) or NULL (Default)
+ *   Level            [I] Structure-Level (must be 1)
+ *   pDriverDirectory [O] PTR to Buffer that receives the Result
+ *   cbBuf            [I] Size of Buffer at pDriverDirectory
+ *   pcbNeeded        [O] PTR to DWORD that receives the size in Bytes used / 
+ *                        required for pDriverDirectory
+ *
+ * RETURNS
+ *   Success: TRUE  and in pcbNeeded the Bytes used in pDriverDirectory
+ *   Failure: FALSE and in pcbNeeded the Bytes required for pDriverDirectory,
+ *   if cbBuf is to small
+ * 
+ *   Native Values returned in pDriverDirectory on Success:
+ *|  NT(Windows NT x86):  "%winsysdir%\\spool\\DRIVERS\\w32x86" 
+ *|  NT(Windows 4.0):     "%winsysdir%\\spool\\DRIVERS\\win40" 
+ *|  win9x(Windows 4.0):  "%winsysdir%" 
+ *
+ *   "%winsysdir%" is the Value from GetSystemDirectoryW()
+ *
+ * FIXME
+ *-  pName != NULL not supported
+ *-  pEnvironment != NULL not supported
+ *-  Current Implementation returns always "%winsysdir%"
+ *
  */
 BOOL WINAPI GetPrinterDriverDirectoryW(LPWSTR pName, LPWSTR pEnvironment,
 				       DWORD Level, LPBYTE pDriverDirectory,
@@ -3271,6 +3300,14 @@ BOOL WINAPI GetPrinterDriverDirectoryW(L
 
 /*****************************************************************************
  *       GetPrinterDriverDirectoryA  [WINSPOOL.@]
+ *
+ * Return the PATH for the Printer-Drivers (ANSI)
+ *
+ * See GetPrinterDriverDirectoryW.
+ *
+ * NOTES
+ * On NT, pDriverDirectory need the same Size as the Unicode-Version
+ *
  */
 BOOL WINAPI GetPrinterDriverDirectoryA(LPSTR pName, LPSTR pEnvironment,
 				       DWORD Level, LPBYTE pDriverDirectory,