wine/dlls/winspool info.c

[Alexandre Julliard]

ChangeSet ID:	21499
CVSROOT:	/opt/cvs-commit
Module name:	wine
Changes by:	[e-mail]	2005/11/28 14:04:01

Modified files:
    dlls/winspool  : info.c

Log message:
    Detlef Riekenberg 
    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,