🚭 🦂 🏿 仮想プリンターの実装例を使用してC＃で印刷デバイスを操作する 👩🏾‍🏭 🧑🏿‍🤝‍🧑🏿 🦕

すべてにご挨拶。今日の記事では、システムに新しい印刷モニターをインストールすることから、プリンターポートからプリンターデバイスドライバーによって処理されたドキュメントを受信するまで、印刷デバイスを操作するマネージコードで独自の高レベルAPIを実装する方法について説明します。

前回と同様に、この記事は、ジュニアおよびミドルマネジメントの開発者と知り合うのに役立ちます。素材を学習するプロセスでは、 P / Invokeを使用してC＃で低レベルWinAPI DLLにアクセスする方法、印刷モニター、プリンタードライバー、システムから印刷デバイスをインストール、構成、削除する方法、デバイスから入力をリダイレクトするポートを開いてリンクする方法を学習しますモニターに印刷して、 マーシャリングを適用する重要なポイントを理解します。また、APIを使用してシステム内の印刷デバイスを便利に操作するためのAPIの使用方法、プリンターからの印刷後に処理されたデータをインターセプトする方法、およびそれらをサーバーに送信する方法を把握します。

問題の声明

最初に、この記事で解決する必要があるタスクのおおよそのリストの概要を提案します。次のようにします。

システム内の印刷デバイスの完全なインストールサイクルを制御する機能。
システムから印刷デバイスを取り外す完全なサイクルを管理する機能。
印刷デバイスを構成する機能。
可能であれば、プロジェクトでのコードの再利用を最適化し、API構造を可能な限り機能的かつ便利にします。
APIのフォールトトレランスを最大化することは可能ですが、同時に低レベルのWin32例外へのアクセスを維持します。
Windows XPからWindows 10までのシステムとの互換性を確保します。
APIを使用してコード内の印刷データを処理する機能。

この記事のフレームワークでは、イタリアの開発者Lorenzo Montiによって既に実装されているmfilemon.dll印刷モニターを使用し、公式のMicrosoft PostScriptプリンタードライバーをプリンタードライバーとして使用します。実際、モニターの要件とタスクに応じて、モニターとドライバーはどれでもかまいません。

理論のビット

この記事では、ドキュメントを印刷するための理論的基礎、PCL / PostScriptサポート付きプリンターとGDIプリンターおよびその他のベースの違いについては検討しません。このトピックに関する必要な情報はすべて、ネットワークのオープンスペースに豊富にあります。しかし、私たちのために設定されたタスクをどのように実現するかをよりよく理解するには、まだ何かを知る必要があります。

最も重要なことから始めましょう-スプーラーサービスは、Windowsの印刷プロセスを制御します。 C：/ Windows / System32 /ディレクトリには独自の低レベルドライバwinspool.drvがあります。これには、印刷サービスのシステムディレクトリとシステム内のデフォルトプリンタの名前の取得から、印刷サービスにアクセスし、多くのアクションを実行するための多くのエントリポイントが含まれています印刷ジョブキューを使用した操作。 winspool.hに加えて、独自のモニター（おそらく、今後の記事のいずれかで説明する）を作成する場合は、DDKのwinsplp.hも必要です。これは、スプーラー仕様に従ってドライバーを構築するための追加機能を提供します。。

さらに、Windowsのフル機能の印刷デバイスは、簡単に言えば、モニターポートで開いている印刷モニター、実際の印刷デバイス（プリンター）、およびそのためのプリインストールされたドライバーで構成されています（図1）。 1つのモニターで複数のポートを一度に開くことができ、複数のプリンターを1つのポートに一度に接続できます。これは、システムからコンポーネントを削除するときに考慮する必要があります。たとえば、特定のポートを削除する場合、最初にそれに接続されているすべての印刷デバイスを破棄する必要があります。

P /呼び出す

プラットフォーム呼び出しサービス（PInvoke）は、マネージコード（C＃/ VBおよび.NET）からアンマネージコード（C / C ++およびWinAPI）で記述されたDLLエントリポイント（関数）にアクセスするためのプラットフォームです。 .NETから低レベルコードにアクセスするには、DLLの外部メソッドと、それらで使用される構造を記述する必要があります。各枝を例ごとに順番に検討します。

例1 winspool.drvドライバーからGetPrinterDriverDirectoryメソッドを呼び出します。

まず、メソッドが返すものと、呼び出されたときに引数に何が必要かを知る必要があります。これを行うには、ドキュメントに移動し、メソッドシグネチャの説明を読みます。将来的には、低レベルAPIのドキュメントを常に参照する必要があることに注意してください。これ以降、特定のメソッド/構造を実装するときにこのアクションの必要性を示すことはありません。これらはデフォルトで必要です。

BOOL GetPrinterDriverDirectory( _In_ LPTSTR pName, _In_ LPTSTR pEnvironment, _In_ DWORD Level, _Out_ LPBYTE pDriverDirectory, _In_ DWORD cbBuf, _Out_ LPDWORD pcbNeeded );

各関数パラメータの説明は、ドキュメントにも記載されています。パラメーターは入力のみ（In）、出力のみ（Out）、入力と出力の両方を同時に（In / Out）、オプション（他のパラメーターに応じて入力または出力のいずれか）にできることを理解することが重要です。また、 WDT型にマッピングする必要がある.NETのデータ型を知る必要があります（ここでは、ほとんどの場合、「重要な.NET型に割り当てられたメモリのサイズは、基本的なC ++型に割り当てられたメモリのサイズに対応し、残りはIntPtrになります 」）。

次に、受け取った情報に基づいて、C＃のマネージコードでメソッドを説明します。

 [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] extern bool GetPrinterDriverDirectory(string serverName, string environment, uint level, [Out] StringBuilder driverDirectory, uint bufferSize, ref uint bytesNeeded);

DllImportAttribute属性を使用すると、低レベルのエントリポイントにアクセスするためのパラメーターを指定できます。 WinAPIでは、ほとんどの関数はUnicodeとANSIの2つの主要なエンコーディングを考慮して記述されています。関数の末尾はそれぞれWとAです。エンコードで特定のメソッドを参照する必要があるが、説明したメソッドのメイン名をリファクタリングしたくない場合は、対応する属性引数（たとえば、GetPrinterDriverDirectoryW）に渡すことでエントリポイントの名前を明示的に指定できます。また、引数CharSet = CharSet.Unicodeを指定することを忘れないでください（この場合、エンコードは自動的に決定されます）。他のすべての有用な属性については、公式ドキュメントで情報を見つけることができます。

ほとんどの場合、 InAttribute属性は省略できます。 C＃メソッドの引数は、デフォルトで値によって渡されます。渡された引数の型が参照であるが、データを出力する必要がある場合に、 OutAttribute属性を指定します。有効な型の引数の出力には、 refを指定します。引数を参照渡しします。

例2 winspool.drvドライバーからAddMonitorメソッドを呼び出します。

この例では、 MONITOR_INFO_2データ構造を使用します。最初にC＃コードで説明する必要があります。

 typedef struct _MONITOR_INFO_2 { LPTSTR pName; LPTSTR pEnvironment; LPTSTR pDLLName; } MONITOR_INFO_2, *PMONITOR_INFO_2; BOOL AddMonitor( _In_ LPTSTR pName, _In_ DWORD Level, _In_ LPBYTE pMonitors );

ここで、「フォーク」言語を話す構造は、値を格納する特定のサイズの割り当てられたメモリセクションのセットであることを理解することが重要です。これらの各セクションは、特定のタイプのデータフィールドを表します。フィールド名とその属性、可変型（クラス）に固有のメタデータ、データストレージに割り当てられたメモリのサイズについては説明していません。これは、構造体の名前だけでなく、構造体の名前も任意であり、割り当てられたメモリサイズと各メンバーの対応を観察することが重要であることを意味します。このような目的のために、メモリ内のクラスまたは構造のデータフィールドの物理的な配置を制御できるStructLayoutAttribute属性があります。メモリ内のこれらのフィールドの配置を制御する方法は多数あります。フィールドのオフセットを明示的に設定し、構造の絶対サイズを指定し、マーシャリング方法のエンコーディングを指定し、パッケージ化し、フィールドセグメントを連続した順に配置することなどができます。ここでこれらのメソッドの実装の例を見つけることができます。具体的には、LayoutKind.Sequentialを使用して指定する最後のメソッドは、タスクに最適です。

 [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)] struct MonitorInfo { [MarshalAs(UnmanagedType.LPTStr)] public string Name; [MarshalAs(UnmanagedType.LPTStr)] public string Environment; [MarshalAs(UnmanagedType.LPTStr)] public string DllName; } [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] static extern bool AddMonitor(string serverName, uint level, ref MonitorInfo monitor);

仕組み：構造体を宣言し、属性でLayoutKind.Sequentialを使用してメモリ内のフィールドの配置を指定し、フィールドデータ型を指定しました。WinAPIの場合、構造体のデータ型は重要です。つまり、アンマネージコードではsizeof（）です 。管理対象-Marshal.SizeOf（）で 。それだけです

マーシャリング

「マーシャリング」（別名「マーシャリング」、別名「マーシャリング」）の概念は、メモリに保存されたデータをある表現から別の表現に変換するプロセスを説明します。一般的な.NETの場合、特にP / Invokeの場合、アンマネージコードからCLRへの型変換です。マーシャリングにより、マネージコードでメモリを操作しやすくなります。これらの目的のために、2つの主要なクラス、 MarshalとMarshalAsAttributeが提供されています。 MarshalAsAttribute属性を使用すると、アンマネージコードからマネージコードへの変換の型一致を明示的に設定できます（型のシリアル化中のマッピングと同様）。これは、タイプフィールド、 param：を介した指定を持つメソッドパラメーター、およびreturn：を介した戻り値にのみ適用できます。 Marshalクラスには、ポインターの操作、メモリの割り当て、サイズ変更、シフトなどのための多くの便利な静的メソッドが含まれています。また、 FlagsAttribute属性は役に立ちます。これにより、低レベルのビットフラグからenumのC＃への変換を構成できます。

将来のAPIアーキテクチャ

理論が整理されたら、将来のAPIのアーキテクチャを検討するときが来ました。特定の哲学や最適な哲学はありません。誰もが解決する問題の状態に応じて、コード設計の必要なパターンを選択します。今回のケースでは、次のことを行うことにしました。将来のライブラリのすべてのコードは、2つの主要なモジュールで構成されます-クラスの「ファクトリー」とこれらのクラスを実装するインターフェースです。パブリック実装により、システムにインストールされているすべてのコンポーネントのリストの取得、コンポーネントのインストール/アンインストールなどが可能になります。内部実装は、マーシャリングとP / Invokeで機能します。特定のケースについては、クラスのインスタンスを作成し、それらのメソッドを呼び出すことができます。基本的なケースについては、「工場」に連絡します。視覚的には、これはすべて次のように表すことができます（図2）。

この記事のフレームワーク内で問題を解決するには、IMonitor、IPort、IDriver、IPrinterの実装、PrintingApiファクトリクラス自体、および補助フラグが必要です。残りは今のところ省略されています。

コードベース

まず、すべての印刷コンポーネントの基本的なインターフェースを作成しましょう。

 /// <summary> ///      ,    ( ,  , ). /// </summary> public interface IPrintableDevice { /// <summary> ///   . /// </summary> string Name { get; } /// <summary> ///      . /// </summary> /// <param name="serverName"> .</param> void Install(string serverName); /// <summary> ///      . /// </summary> /// <param name="serverName"> .</param> void Uninstall(string serverName); }

ここではすべてが単純です。各コンポーネントには、システムにインストール/アンインストールするための名前と2つの方法があり、リモートマシンで作業することができます。

次に、工場の基礎を記述します。

クラスPrintingApi

 /// <summary> ///  API     . /// </summary> public class PrintingApi { /// <summary> ///       P/Invoke. /// </summary> /// <param name="serverName"> .</param> /// <param name="level">  .</param> /// <param name="structs">   .</param> /// <param name="bufferSize"> .</param> /// <param name="bytesNeeded">     .</param> /// <param name="bufferReturnedLength">   .</param> /// <returns></returns> internal delegate bool EnumInfo(string serverName, uint level, IntPtr structs, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength); /// <summary> ///       P/Invoke. /// </summary> /// <param name="serverName"> .</param> /// <param name="environment">.</param> /// <param name="level">  .</param> /// <param name="structs">   .</param> /// <param name="bufferSize"> .</param> /// <param name="bytesNeeded">     .</param> /// <param name="bufferReturnedLength">   .</param> /// <returns></returns> internal delegate bool EnumInfo2(string serverName, string environment, uint level, IntPtr structs, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength); /// <summary> ///    <see cref="PrintingApi"/>. /// </summary> public static PrintingApi Factory { get; protected set; } /// <summary> ///    <see cref="PrintingApi"/>. /// </summary> static PrintingApi() { Factory = new PrintingApi(); } /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="level"> .</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo handler, string serverName, uint level) where T : struct { uint bytesNeeded = 0; uint bufferReturnedLength = 0; if (handler(serverName, level, IntPtr.Zero, 0, ref bytesNeeded, ref bufferReturnedLength)) return null; int lastWin32Error = Marshal.GetLastWin32Error(); if (lastWin32Error != PrintingException.ErrorInsufficientBuffer) throw new PrintingException(lastWin32Error); IntPtr pointer = Marshal.AllocHGlobal((int)bytesNeeded); try { if (handler(serverName, level, pointer, bytesNeeded, ref bytesNeeded, ref bufferReturnedLength)) { IntPtr currentPointer = pointer; T[] dataCollection = new T[bufferReturnedLength]; Type type = typeof(T); for (int i = 0; i < bufferReturnedLength; i++) { dataCollection[i] = (T)Marshal.PtrToStructure(currentPointer, type); currentPointer = (IntPtr)(currentPointer.ToInt64() + Marshal.SizeOf(type)); } return dataCollection; } throw new PrintingException(Marshal.GetLastWin32Error()); } catch (Exception e) { throw new PrintingException(e.Message, e); } finally { Marshal.FreeHGlobal(pointer); } } /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo handler, string serverName) where T : struct => GetInfo<T>(handler, serverName, 2); /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="level"> .</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo handler, uint level) where T : struct => GetInfo<T>(handler, null, level); /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo handler) where T : struct => GetInfo<T>(handler, null); /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="arg">  .</param> /// <param name="level"> .</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo2 handler, string serverName, string arg, uint level) where T : struct { uint bytesNeeded = 0; uint bufferReturnedLength = 0; if (handler(serverName, arg, level, IntPtr.Zero, 0, ref bytesNeeded, ref bufferReturnedLength)) return null; int lastWin32Error = Marshal.GetLastWin32Error(); if (lastWin32Error != PrintingException.ErrorInsufficientBuffer) throw new PrintingException(lastWin32Error); IntPtr pointer = Marshal.AllocHGlobal((int)bytesNeeded); try { if (handler(serverName, arg, level, pointer, bytesNeeded, ref bytesNeeded, ref bufferReturnedLength)) { IntPtr currentPointer = pointer; T[] dataCollection = new T[bufferReturnedLength]; Type type = typeof(T); for (int i = 0; i < bufferReturnedLength; i++) { dataCollection[i] = (T)Marshal.PtrToStructure(currentPointer, type); currentPointer = (IntPtr)(currentPointer.ToInt64() + Marshal.SizeOf(type)); } return dataCollection; } throw new PrintingException(Marshal.GetLastWin32Error()); } catch (Exception e) { throw new PrintingException(e.Message, e); } finally { Marshal.FreeHGlobal(pointer); } } /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="arg">  .</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo2 handler, string serverName, string arg) where T : struct => GetInfo<T>(handler, serverName, arg, 2); /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="arg">  .</param> /// <param name="level"> .</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo2 handler, string arg, uint level) where T : struct => GetInfo<T>(handler, null, arg, level); /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="arg">  .</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo2 handler, string arg) where T : struct => GetInfo<T>(handler, null, arg); /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="level"> .</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo2 handler, uint level) where T : struct => GetInfo<T>(handler, null, level); /// <summary> ///     Spooler API.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <returns>   Spooler API.</returns> internal static T[] GetInfo<T>(EnumInfo2 handler) where T : struct => GetInfo<T>(handler, null); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo handler, string serverName, uint level, out T[] dataCollection, out PrintingException e) where T : struct { dataCollection = null; e = null; try { dataCollection = GetInfo<T>(handler, serverName, level); return true; } catch (PrintingException ex) { e = ex; } return false; } /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo handler, string serverName, uint level, out T[] dataCollection) where T : struct => TryGetInfo(handler, serverName, level, out dataCollection, out PrintingException e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo handler, string serverName, out T[] dataCollection, out PrintingException e) where T : struct => TryGetInfo(handler, serverName, 2, out dataCollection, out e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo handler, string serverName, out T[] dataCollection) where T : struct => TryGetInfo(handler, serverName, 2, out dataCollection, out PrintingException e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo handler, uint level, out T[] dataCollection, out PrintingException e) where T : struct => TryGetInfo(handler, null, level, out dataCollection, out e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo handler, uint level, out T[] dataCollection) where T : struct => TryGetInfo(handler, null, level, out dataCollection, out PrintingException e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo handler, out T[] dataCollection, out PrintingException e) where T : struct => TryGetInfo(handler, null, out dataCollection, out e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo handler, out T[] dataCollection) where T : struct => TryGetInfo(handler, null, out dataCollection, out PrintingException e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="arg">  .</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, string serverName, string arg, uint level, out T[] dataCollection, out PrintingException e) where T : struct { dataCollection = null; e = null; try { dataCollection = GetInfo<T>(handler, serverName, arg, level); return true; } catch (PrintingException ex) { e = ex; } return false; } /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="arg">  .</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, string serverName, string arg, uint level, out T[] dataCollection) where T : struct => TryGetInfo(handler, serverName, arg, level, out dataCollection, out PrintingException e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="arg">  .</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, string serverName, string arg, out T[] dataCollection, out PrintingException e) where T : struct => TryGetInfo(handler, serverName, arg, 2, out dataCollection, out e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="serverName"> .</param> /// <param name="arg">  .</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, string serverName, string arg, out T[] dataCollection) where T : struct => TryGetInfo(handler, serverName, arg, 2, out dataCollection, out PrintingException e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="arg">  .</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, string arg, uint level, out T[] dataCollection, out PrintingException e) where T : struct => TryGetInfo(handler, null, arg, level, out dataCollection, out e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="arg">  .</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, string arg, uint level, out T[] dataCollection) where T : struct => TryGetInfo(handler, null, arg, level, out dataCollection, out PrintingException e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="arg">  .</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, string arg, out T[] dataCollection, out PrintingException e) where T : struct => TryGetInfo(handler, null, arg, out dataCollection, out e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="arg">  .</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, string arg, out T[] dataCollection) where T : struct => TryGetInfo(handler, null, arg, out dataCollection, out PrintingException e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, uint level, out T[] dataCollection, out PrintingException e) where T : struct => TryGetInfo(handler, null, level, out dataCollection, out e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="level"> .</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, uint level, out T[] dataCollection) where T : struct => TryGetInfo(handler, null, level, out dataCollection, out PrintingException e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="dataCollection">   Spooler API.</param> /// <param name="e">,    .</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, out T[] dataCollection, out PrintingException e) where T : struct => TryGetInfo(handler, null, out dataCollection, out e); /// <summary> ///     Spooler API      True.       P/Invoke. /// </summary> /// <typeparam name="T"> .</typeparam> /// <param name="handler">-    Spooler API.</param> /// <param name="dataCollection">   Spooler API.</param> /// <returns>True,    ,  False.</returns> internal static bool TryGetInfo<T>(EnumInfo2 handler, out T[] dataCollection) where T : struct => TryGetInfo(handler, null, out dataCollection, out PrintingException e); }

文書化されたコメントから、何が何であるかは明らかだと思います。singleton を使用して、静的コンストラクターでクラスの新しい静的インスタンスを作成し、EnumInfoおよびEnumInfo2の 2つのデリゲートを記述して、将来のクラスでデータを受け取るためのネイティブメソッドを呼び出し、ネイティブメソッドでヘルパーメソッドを記述します。

ほとんどの場合、ネイティブメソッドを操作するプロセス全体は、次の一連のアクションに削減されます。

, false 122 (« »). () . , , , ;
. Marshal.AllocHGlobal() , ( ) IntPtr ;
. Marshal.PtrToStructure() , Marshal.StructureToPtr , ;
Marshal.GetLastWin32Error（）を使用してWin32エラーの可能性をインターセプトすることを忘れないでください。また、Marshal.FreeHGlobal（）を使用してバッファ用に以前に割り当てられたメモリを解放してください。

char **バッファー（文字列配列）を操作するには、StringBuilderを使用することをお勧めします。ポインターで動作する既製のオーバーロードがあり、マーシャリングに必要なすべての機能も実装しています。

例外をキャッチしてスローするために、APIに別のクラスを提供します。

クラスPrintingException

 /// <summary> ///    . /// </summary> [Serializable] public class PrintingException : Win32Exception { #region Error Codes /// <summary> ///   "  ". /// </summary> public const int ErrorFileNotFound = 2; /// <summary> ///   " ". /// </summary> public const int ErrorInsufficientBuffer = 122; /// <summary> ///   "  ". /// </summary> public const int ErrorModuleNotFound = 126; /// <summary> ///   "   ". /// </summary> public const int ErrorInvalidPrinterName = 1801; /// <summary> ///   "   ". /// </summary> public const int ErrorMonitorUnknown = 3000; /// <summary> ///   "   ". /// </summary> public const int ErrorPrinterDriverIsReadyUsed = 3001; /// <summary> ///   "    ". /// </summary> public const int ErrorPrinterJobFileNotFound = 3002; /// <summary> ///   "    StartDocPrinter". /// </summary> public const int ErrorStartDocPrinterNotCalling = 3003; /// <summary> ///   "    AddJob". /// </summary> public const int ErrorAddJobNotCalling = 3004; /// <summary> ///   "    ". /// </summary> public const int ErrorPrinterProcessorAlreadyInstalled = 3005; /// <summary> ///   "    ". /// </summary> public const int ErrorMonitorAlreadyInstalled = 3006; /// <summary> ///   "      ". /// </summary> public const int ErrorInvalidMonitor = 3007; /// <summary> ///   "     ". /// </summary> public const int ErrorMonitorIsReadyUsed = 3008; #endregion /// <summary> ///     <see cref="PrintingException"/>. /// </summary> public PrintingException() : base() { } /// <summary> ///     <see cref="PrintingException"/>. /// </summary> /// <param name="nativeErrorCode">  Win32.</param> public PrintingException(int nativeErrorCode) : base(nativeErrorCode) { } /// <summary> ///     <see cref="PrintingException"/>. /// </summary> /// <param name="message">  .</param> public PrintingException(string message) : base(message) { } /// <summary> ///     <see cref="PrintingException"/>. /// </summary> /// <param name="nativeErrorCode">  Win32.</param> /// <param name="message">  .</param> public PrintingException(int nativeErrorCode, string message) : base(nativeErrorCode, message) { } /// <summary> ///     <see cref="PrintingException"/>. /// </summary> /// <param name="message">  .</param> /// <param name="innerException"></param> public PrintingException(string message, Exception innerException) : base(message, innerException) { } /// <summary> ///     <see cref="PrintingException"/>. /// </summary> /// <param name="info">  .</param> /// <param name="context">  .</param> public PrintingException(SerializationInfo info, StreamingContext context) : base(info, context) { } }

ここでは、便宜上、印刷サービスを使用する際のネイティブエラーの基本コードをすぐに規定しました。

ここで、コードをより便利に使用し、無効な引数のネイティブメソッドへの転送を最小限に抑えるために、いくつかの列挙型を実装する必要があります。

 /// <summary> ///  . /// </summary> public enum Environment { /// <summary> ///   . /// </summary> Current, /// <summary> /// Windows NT x86. /// </summary> X86, /// <summary> /// Windows x64. /// </summary> X64, /// <summary> /// Windows IA64. /// </summary> IA64, } /// <summary> ///     . /// </summary> [Flags] public enum PortType { /// <summary> ///  . /// </summary> Write = 0x1, /// <summary> ///  . /// </summary> Read = 0x2, /// <summary> ///  . /// </summary> Redirected = 0x4, /// <summary> ///    . /// </summary> NetAttached = 0x8, } /// <summary> ///   . /// </summary> public enum DataType : uint { RAW = 1, LPR = 2, }

環境を文字列に、またはその逆に変換するには、2つの拡張メソッドを実装します。

 /// <summary> ///     . /// </summary> public static class PrintingExtensions { /// <summary> ///    ,   WinAPI. /// </summary> /// <param name="environment"> .</param> /// <returns>    .</returns> internal static string GetEnvironmentName(this Environment environment) { switch (environment) { default: return null; case Environment.X86: return "Windows x86"; case Environment.X64: return "Windows x64"; case Environment.IA64: return "Windows IA64"; } } /// <summary> ///  <see cref="Environment"/>,     . /// </summary> /// <param name="environmentString">   .</param> /// <returns><see cref="Environment"/>,     .</returns> internal static Environment GetEnvironment(this string environmentString) { environmentString = environmentString.ToLower(); if (environmentString.Contains("x86")) return Environment.X86; if (environmentString.Contains("x64")) return Environment.X64; if (environmentString.Contains("ia64")) return Environment.IA64; return Environment.Current; } }

2つの拡張メソッドとenum Environmentの代わりに、通常の文字列定数でうまくいくことができます。最初に環境の名前で無効なギャグを渡すことを禁止したかっただけで、この方法で行きましたが、同時に、事前定義された制限された行セットから選択する機能を保持します。

各クラスのコンポーネントをインストールおよび削除するためのオーバーロードメソッドを記述しないように、基本的な抽象クラスを実装します。

抽象クラスPrintableDevice

 /// <summary> ///        . /// </summary> public abstract class PrintableDevice : IPrintableDevice { /// <summary> ///    . /// </summary> public virtual string Name { get; protected set; } /// <summary> ///     <see cref="PrintableDevice"/>. /// </summary> /// <param name="name"></param> /// <exception cref="ArgumentNullException"/> public PrintableDevice(string name) { if (string.IsNullOrEmpty(name)) throw new ArgumentNullException("name"); Name = name; } /// <summary> ///       . /// </summary> /// <param name="serverName"> .</param> /// <exception cref="FileNotFoundException" /> /// <exception cref="PrintingException" /> public abstract void Install(string serverName); /// <summary> ///       . /// </summary> /// <exception cref="FileNotFoundException" /> /// <exception cref="PrintingException" /> public void Install() => Install(null); /// <summary> ///       . /// </summary> /// <param name="serverName"> .</param> /// <param name="e">,    .</param> /// <returns>True,     ,  False.</returns> public bool TryInstall(string serverName, out PrintingException e) { e = null; try { Install(serverName); } catch (PrintingException ex) { e = ex; return false; } return true; } /// <summary> ///       . /// </summary> /// <param name="serverName"> .</param> /// <returns>True,     ,  False.</returns> public bool TryInstall(string serverName) => TryInstall(serverName, out PrintingException e); /// <summary> ///       . /// </summary> /// <param name="e">,    .</param> /// <returns>True,     ,  False.</returns> public bool TryInstall(out PrintingException e) => TryInstall(null, out e); /// <summary> ///       . /// </summary> /// <returns>True,     ,  False.</returns> public bool TryInstall() => TryInstall(out PrintingException e); /// <summary> ///       . /// </summary> /// <param name="serverName"> .</param> /// <exception cref="PrintingException" /> public abstract void Uninstall(string serverName); /// <summary> ///       . /// </summary> /// <exception cref="PrintingException" /> public void Uninstall() => Uninstall(null); /// <summary> ///       . /// </summary> /// <param name="serverName"> .</param> /// <param name="e">,    .</param> /// <returns>True,     ,  False.</returns> public bool TryUninstall(string serverName, out PrintingException e) { e = null; try { Uninstall(serverName); } catch (PrintingException ex) { e = ex; return false; } return true; } /// <summary> ///       . /// </summary> /// <param name="serverName"> .</param> /// <returns>True,     ,  False.</returns> public bool TryUninstall(string serverName) => TryUninstall(serverName, out PrintingException e); /// <summary> ///       . /// </summary> /// <param name="e">,    .</param> /// <returns>True,     ,  False.</returns> public bool TryUninstall(out PrintingException e) => TryUninstall(null, out e); /// <summary> ///       . /// </summary> /// <returns>True,     ,  False.</returns> public bool TryUninstall() => TryUninstall(out PrintingException e); }

プリントモニター

印刷モニタの実装を開始します。まず、理論的な部分ですでに説明したネイティブ構造が必要です。

struct MonitorInfo

 /// <summary> ///        . /// </summary> [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)] internal struct MonitorInfo { /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string Name; /// <summary> /// ,      (, Windows NT x86, Windows IA64  Windows x64). /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string Environment; /// <summary> ///   *.dll . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string DllName; }

次に、印刷モニターを実装するためのインターフェースが必要です。

インターフェースIMonitor

 /// <summary> ///       . /// </summary> public interface IMonitor : IPrintableDevice { /// <summary> /// ,      (, Windows NT x86, Windows IA64  Windows x64). /// </summary> Environment Environment { get; } /// <summary> ///   *.dll . /// </summary> string Dll { get; } }

今のところこれで十分です。将来、ポリモーフィズムに違反することなく機能を拡張する必要がある場合、インターフェイスのおかげで、このタスクを簡単に実装できます。

また、記事の理論ブロックでシステムにモニターを追加するネイティブメソッドについても説明しましたが、インストールされたモニターのリストを取得し、モニターを削除して、モニターのクラスを実装する方法について説明します。

クラスモニター

 /// <summary> ///      . /// </summary> public class Monitor : PrintableDevice, IMonitor { /// <summary> /// ,      (, Windows NT x86, Windows IA64  Windows x64). /// </summary> public virtual Environment Environment { get; protected set; } /// <summary> ///   *.dll . /// </summary> public virtual string Dll { get; protected set; } /// <summary> ///        . /// </summary> public static Monitor[] All { get { if (!PrintingApi.TryGetInfo(EnumMonitors, out MonitorInfo[] monitorInfo)) return null; Monitor[] monitors = new Monitor[monitorInfo.Length]; for (int i = 0; i < monitorInfo.Length; i++) monitors[i] = new Monitor(monitorInfo[i].Name, monitorInfo[i].DllName, monitorInfo[i].Environment.GetEnvironment()); return monitors; } } /// <summary> ///     <see cref="Monitor"/>. /// </summary> /// <param name="name">  .</param> /// <param name="dll">  *.dll .</param> /// <param name="environment">,      (, Windows NT x86, Windows IA64  Windows x64).</param> /// <exception cref="ArgumentNullException" /> public Monitor(string name, string dll, Environment environment) : base(name) { if (string.IsNullOrEmpty(dll)) throw new ArgumentNullException("dll"); Environment = environment; Dll = dll; } /// <summary> ///     <see cref="Monitor"/>. /// </summary> /// <param name="name">  .</param> /// <param name="dll">  *.dll .</param> /// <exception cref="ArgumentNullException" /> public Monitor(string name, string dll) : this(name, dll, Environment.Current) { } /// <summary> ///      . /// </summary> /// <param name="serverName"> .</param> /// <exception cref="FileNotFoundException"/> /// <exception cref="PrintingException"/> public override void Install(string serverName) { try { if (!File.Exists(Dll)) throw new FileNotFoundException("     ", Dll); string dllName = Path.GetFileName(Dll); string dllPath = Path.Combine(System.Environment.SystemDirectory, dllName); File.Copy(Dll, dllPath, true); MonitorInfo monitorInfo = new MonitorInfo { Name = Name, Environment = Environment.GetEnvironmentName(), DllName = File.Exists(dllPath) ? dllName : Dll, }; if (AddMonitor(serverName, 2, ref monitorInfo)) return; if (Marshal.GetLastWin32Error() == PrintingException.ErrorMonitorAlreadyInstalled && TryUninstall(serverName) && AddMonitor(serverName, 2, ref monitorInfo)) return; else throw new PrintingException(Marshal.GetLastWin32Error()); } catch (Exception e) { throw new PrintingException(e.Message, e); } } /// <summary> ///      . /// </summary> /// <param name="serverName"> .</param> /// <exception cref="PrintingException"/> public override void Uninstall(string serverName) { try { if (!All.Select(m => m.Name).Contains(Name)) return; /// TODO:      . if (DeleteMonitor(serverName, Environment.GetEnvironmentName(), Name)) return; if (Marshal.GetLastWin32Error() == PrintingException.ErrorMonitorUnknown) return; if (DeleteMonitor(serverName, Environment.GetEnvironmentName(), Name)) return; throw new PrintingException(Marshal.GetLastWin32Error()); } catch (Exception e) { throw new PrintingException(e.Message, e); } } #region Native /// <summary> ///      . /// </summary> /// <param name="serverName"> ,     .   null -    .</param> /// <param name="level">  .    2.</param> /// <param name="monitor">  <see cref="MonitorInfo"/>.</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool AddMonitor(string serverName, uint level, ref MonitorInfo monitor); /// <summary> ///       <see cref="MonitorInfo"/>. /// </summary> /// <param name="serverName"> ,      .   null -    .</param> /// <param name="level">  .    1  2.</param> /// <param name="monitors">     <see cref="MonitorInfo"/>.</param> /// <param name="bufferSize">    <see cref="MonitorInfo"/> ( ).</param> /// <param name="bytesNeeded">    .</param> /// <param name="bufferReturnedLength">  .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool EnumMonitors(string serverName, uint level, IntPtr monitors, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength); /// <summary> ///      . /// </summary> /// <param name="serverName"> ,     .   null -    .</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="monitorName">  .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool DeleteMonitor(string serverName, string environment, string monitorName); #endregion }

これで、同じクラスの印刷モニターを操作するために必要な機能がすべて揃いました。ファクトリにモニターインスタンスを作成するメソッドも追加します。

PrintingApiクラスの機能を拡張する

 /// <summary> ///       . /// </summary> public static Monitor[] Monitors => Monitor.All; /// <summary> ///      . /// </summary> /// <param name="name">  .</param> /// <param name="dll">   dll  .</param> /// <param name="environment">,      .</param> /// <param name="serverName"> ,      .</param> /// <returns>  .</returns> public Monitor CreateMonitor(string name, string dll, Environment environment, string serverName) { Monitor monitor = new Monitor(name, dll, environment); monitor.TryInstall(serverName); return monitor; } /// <summary> ///      . /// </summary> /// <param name="name">  .</param> /// <param name="dll">   dll  .</param> /// <param name="environment">,      .</param> /// <returns>  .</returns> public Monitor CreateMonitor(string name, string dll, Environment environment) => CreateMonitor(name, dll, environment, null); /// <summary> ///      . /// </summary> /// <param name="name">  .</param> /// <param name="dll">   dll  .</param> /// <param name="serverName"> ,      .</param> /// <returns>  .</returns> public Monitor CreateMonitor(string name, string dll, string serverName) => CreateMonitor(name, dll, Environment.Current, null); /// <summary> ///      . /// </summary> /// <param name="name">  .</param> /// <param name="dll">   dll  .</param> /// <returns>  .</returns> public Monitor CreateMonitor(string name, string dll) => CreateMonitor(name, dll, null);

コードの操作性を検証します。ユニットテストを追加し、便宜上、モニターDLLの名前とパス定数を規定し、メインコードセグメントをカバーするテストメソッドを実装します。

印刷モニターの単体テスト

 /// <summary> ///     <see cref="Monitor"/>. /// </summary> [TestClass] public class MonitorTests { /// <summary> ///  . /// </summary> protected const string MonitorName = "Test Monitor"; /// <summary> ///   dll . /// </summary> protected const string MonitorDll = "D:/Printing Tests/mfilemon.dll"; /// <summary> ///    dll . /// </summary> protected const string FailedMonitorDll = "noexist.dll"; /// <summary> ///    . /// </summary> [TestMethod] public void InstallTest() { Monitor monitor = new Monitor(MonitorName, MonitorDll); monitor.Install(); Assert.IsTrue(Monitor.All.Select(m => m.Name).Contains(MonitorName)); } /// <summary> ///    . /// </summary> [TestMethod] public void UninstallTest() { Monitor monitor = new Monitor(MonitorName, MonitorDll); monitor.Uninstall(); Assert.IsFalse(Monitor.All.Select(m => m.Name).Contains(MonitorName)); } /// <summary> ///        . /// </summary> [TestMethod] public void TryInstallTest() { Monitor monitor = new Monitor(MonitorName, MonitorDll); bool f = monitor.TryInstall(); Assert.IsTrue(f); Assert.IsTrue(Monitor.All.Select(m => m.Name).Contains(MonitorName)); } /// <summary> ///        . /// </summary> [TestMethod] public void TryUninstallTest() { Monitor monitor = new Monitor(MonitorName, MonitorDll); bool f = monitor.TryUninstall(); Assert.IsTrue(f); Assert.IsFalse(Monitor.All.Select(m => m.Name).Contains(MonitorName)); } /// <summary> ///     . /// </summary> [TestMethod] [ExpectedException(typeof(PrintingException))] public void InstallFailedTest() { Monitor monitor = new Monitor(MonitorName, FailedMonitorDll); monitor.Install(); Assert.IsFalse(Monitor.All.Select(m => m.Name).Contains(MonitorName)); } /// <summary> ///         . /// </summary> [TestMethod] public void TryInstallFailedTest() { Monitor monitor = new Monitor(MonitorName, FailedMonitorDll); bool f = monitor.TryInstall(); Assert.IsFalse(f); Assert.IsFalse(Monitor.All.Select(m => m.Name).Contains(MonitorName)); }

プリントモニターをテストディレクトリmfilemon.dllにドロップすることを忘れないでください。

港

ポートについても同じことを行います。まず、IPortが必要です。

インターフェイスiport

 /// <summary> ///       . /// </summary> public interface IPort : IPrintableDevice { /// <summary> /// ,    . /// </summary> IMonitor Monitor { get; } /// <summary> ///  . /// </summary> string Description { get; } /// <summary> ///  . /// </summary> PortType Type { get; } }

次に、ネイティブポートのデータ構造について説明します。

struct portInfo

 /// <summary> ///      . /// </summary> [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)] public struct PortInfo { /// <summary> ///    (, "LPT1:"). /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string PortName; /// <summary> ///     (, "PJL monitor").    null. /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string MonitorName; /// <summary> ///   (,  <see cref="PortName"/>  "LPT1:", <see cref="Description"/>   "printer port").    null. /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string Description; /// <summary> ///  . /// </summary> public PortType Type; /// <summary> /// .    0. /// </summary> internal uint Reserved; }

スプーラーは、ポートを開閉する2つの方法を提供します。1つ目は基本的なAddPort / DeletePortメソッドを使用する方法、2つ目はXcvDataツールとその上のさまざまなヘルパーを使用する方法です。2番目のオプションが望ましいのは、最初のケースでは、インストールプロセスのダイアログボックスへのポインタが必要ですが、これは必要ありません。XCVには、さらに次のものが必要です。

列挙型PrinterAccess-プリンターデータへのアクセス権

 /// <summary> ///    . /// </summary> internal enum PrinterAccess { /// <summary> ///     . /// </summary> ServerAdmin = 0x01, /// <summary> ///     . /// </summary> ServerEnum = 0x02, /// <summary> ///     . /// </summary> PrinterAdmin = 0x04, /// <summary> ///     . /// </summary> PrinterUse = 0x08, /// <summary> ///      . /// </summary> JobAdmin = 0x10, /// <summary> ///    . /// </summary> JobRead = 0x20, /// <summary> ///   . /// </summary> StandardRightsRequired = 0x000F0000, /// <summary> ///   . /// </summary> PrinterAllAccess = (StandardRightsRequired | PrinterAdmin | PrinterUse), }

struct PrinterDefaults-XcvDataのプリンター設定

 /// <summary> ///     <see cref="Port.XcvData(IntPtr, string, IntPtr, uint, IntPtr, uint, out uint, out uint)"/>. /// </summary> [StructLayout(LayoutKind.Sequential)] internal struct PrinterDefaults { /// <summary> ///   (   null). /// </summary> public IntPtr DataType; /// <summary> ///   (   null). /// </summary> public IntPtr DevMode; /// <summary> ///    . /// </summary> public PrinterAccess DesiredAccess; }

struct PortData-XcvDataのポートデータ構造

 /// <summary> ///     <see cref="Port.XcvData(System.IntPtr, string, System.IntPtr, uint, System.IntPtr, uint, out uint, out uint)"/>. /// </summary> [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)] internal struct PortData { /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)] public string PortName; /// <summary> ///   (   1). /// </summary> public uint Version; /// <summary> /// . /// </summary> public DataType Protocol; /// <summary> ///   . /// </summary> public uint BufferSize; /// <summary> ///   . /// </summary> public uint ReservedSize; /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 49)] public string HostAddress; [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 33)] public string SNMPCommunity; public uint DoubleSpool; [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 33)] public string Queue; /// <summary> /// IP-. /// </summary> [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 16)] public string IPAddress; /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.ByValArray, SizeConst = 540)] public byte[] Reserved; /// <summary> ///  . /// </summary> public uint PortNumber; public uint SNMPEnabled; public uint SNMPDevIndex; }

列挙型XcvDataType-XcvDataの操作タイプ

 /// <summary> ///    <see cref="Port.XcvData(IntPtr, string, IntPtr, uint, IntPtr, uint, out uint, out uint)"/>. /// </summary> internal enum XcvDataType { /// <summary> ///   . /// </summary> AddPort, /// <summary> ///   . /// </summary> DeletePort, }

さて、これでポートクラスを実装するために必要なものがすべて揃いました。

クラスポート

 /// <summary> ///     . /// </summary> public class Port : PrintableDevice, IPort { /// <summary> /// ,    . /// </summary> public virtual IMonitor Monitor { get; protected set; } /// <summary> ///  . /// </summary> public virtual string Description { get; protected set; } /// <summary> ///  . /// </summary> public virtual PortType Type { get; protected set; } /// <summary> ///        . /// </summary> public static Port[] All { get { if (!PrintingApi.TryGetInfo(EnumPorts, out PortInfo[] portInfo)) return null; Port[] ports = new Port[portInfo.Length]; for (int i = 0; i < portInfo.Length; i++) ports[i] = new Port(portInfo[i].PortName, portInfo[i].Description, portInfo[i].Type, portInfo[i].MonitorName); return ports; } } /// <summary> ///     <see cref="Port"/>. /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="type"> .</param> /// <param name="monitorName">  ,    .</param> /// <exception cref="ArgumentNullException"/> /// <exception cref="PrintingException"/> public Port(string name, string description, PortType type, string monitorName) : base(name) { Description = description; Type = type; Monitor[] monitors = PrintingApi.Monitors; if (monitors.Select(m => m.Name).Contains(monitorName)) Monitor = monitors.Where(m => m.Name == monitorName).FirstOrDefault(); } /// <summary> ///     <see cref="Port"/>. /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="type"> .</param> /// <param name="monitor"> ,    .</param> /// <exception cref="ArgumentNullException"/> /// <exception cref="PrintingException"/> public Port(string name, string description, PortType type, IMonitor monitor) : this(name, description, type, monitor?.Name) { } /// <summary> ///     <see cref="Port"/>. /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="type"> .</param> /// <exception cref="ArgumentNullException"/> /// <exception cref="PrintingException"/> public Port(string name, string description, PortType type) : this(name, description, type, null as string) { } /// <summary> ///     <see cref="Port"/>. /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="monitorName">  ,    .</param> /// <exception cref="ArgumentNullException"/> /// <exception cref="PrintingException"/> public Port(string name, string description, string monitorName) : this(name, description, PortType.Redirected, monitorName) { } /// <summary> ///     <see cref="Port"/>. /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="monitor"> ,    .</param> /// <exception cref="ArgumentNullException"/> /// <exception cref="PrintingException"/> public Port(string name, string description, IMonitor monitor) : this(name, description, PortType.Redirected, monitor) { } /// <summary> ///     <see cref="Port"/>. /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <exception cref="ArgumentNullException"/> /// <exception cref="PrintingException"/> public Port(string name, string description) : this(name, description, null as string) { } /// <summary> ///     <see cref="Port"/>. /// </summary> /// <param name="name"> .</param> /// <param name="monitor"> ,    .</param> /// <exception cref="ArgumentNullException"/> /// <exception cref="PrintingException"/> public Port(string name, IMonitor monitor) : this(name, null, monitor) { } /// <summary> ///     <see cref="Port"/>. /// </summary> /// <param name="name"> .</param> /// <param name="type"> .</param> /// <exception cref="ArgumentNullException"/> /// <exception cref="PrintingException"/> public Port(string name, PortType type) : this(name, null, type) { } /// <summary> ///     <see cref="Port"/>. /// </summary> /// <param name="name"> .</param> /// <exception cref="ArgumentNullException"/> /// <exception cref="PrintingException"/> public Port(string name) : this(name, null as string) { } /// <summary> ///     . /// </summary> /// <param name="serverName"> .</param> /// <exception cref="FileNotFoundException"/> /// <exception cref="PrintingException"/> public override void Install(string serverName) { try { if (All.Select(p => p.Name).Contains(Name)) Uninstall(serverName); PrinterDefaults defaults = new PrinterDefaults { DesiredAccess = PrinterAccess.ServerAdmin }; if (!OpenPrinter($",XcvMonitor {Monitor.Name}", out IntPtr printerHandle, ref defaults)) throw new PrintingException(Marshal.GetLastWin32Error()); PortData portData = new PortData { Version = 1, Protocol = DataType.RAW, PortNumber = 9100, // 9100 = RAW, 515 = LPR. ReservedSize = 0, PortName = Name, IPAddress = serverName, SNMPCommunity = "public", SNMPEnabled = 1, SNMPDevIndex = 1, }; uint size = (uint)Marshal.SizeOf(portData); portData.BufferSize = size; IntPtr pointer = Marshal.AllocHGlobal((int)size); Marshal.StructureToPtr(portData, pointer, true); try { IntPtr outputData = IntPtr.Zero; uint outputDataSize = 0; if (!XcvData(printerHandle, Enum.GetName(typeof(XcvDataType), XcvDataType.AddPort), pointer, size, outputData, outputDataSize, out uint outputNeeded, out uint status)) throw new PrintingException(Marshal.GetLastWin32Error()); } catch (Exception e) { throw new PrintingException(e.Message, e); } finally { Marshal.FreeHGlobal(pointer); ClosePrinter(printerHandle); } } catch (Exception e) { throw new PrintingException(e.Message, e); } } /// <summary> ///     . /// </summary> /// <param name="serverName"> .</param> /// <exception cref="FileNotFoundException"/> /// <exception cref="PrintingException"/> public override void Uninstall(string serverName) { try { if (!All.Select(p => p.Name).Contains(Name)) return; /// TODO:   ,   . PrinterDefaults defaults = new PrinterDefaults { DesiredAccess = PrinterAccess.ServerAdmin }; if (!OpenPrinter($",XcvPort {Name}", out IntPtr printerHandle, ref defaults)) throw new PrintingException(Marshal.GetLastWin32Error()); PortData portData = new PortData { Version = 1, Protocol = DataType.RAW, PortNumber = 9100, ReservedSize = 0, PortName = Name, IPAddress = serverName, SNMPCommunity = "public", SNMPEnabled = 1, SNMPDevIndex = 1, }; uint size = (uint)Marshal.SizeOf(portData); portData.BufferSize = size; IntPtr pointer = Marshal.AllocHGlobal((int)size); Marshal.StructureToPtr(portData, pointer, true); try { IntPtr outputData = IntPtr.Zero; uint outputDataSize = 0; if (!XcvData(printerHandle, Enum.GetName(typeof(XcvDataType), XcvDataType.DeletePort), pointer, size, outputData, outputDataSize, out uint outputNeeded, out uint status)) throw new PrintingException(Marshal.GetLastWin32Error()); } catch (Exception e) { throw new PrintingException(e.Message, e); } finally { Marshal.FreeHGlobal(pointer); ClosePrinter(printerHandle); } } catch (Exception e) { throw new PrintingException(e.Message, e); } } #region Native /// <summary> ///    . /// </summary> /// <param name="printerName"> .</param> /// <param name="printer">  .</param> /// <param name="printerDefaults">  <see cref="XcvData(IntPtr, string, IntPtr, uint, IntPtr, uint, out uint, out uint)"/>.</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool OpenPrinter(string printerName, out IntPtr printer, ref PrinterDefaults printerDefaults); /// <summary> ///   . /// </summary> /// <param name="printer"> .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool ClosePrinter(IntPtr printer); /// <summary> ///    . /// </summary> /// <param name="printer">  .</param> /// <param name="dataType"> .</param> /// <param name="inputData"> .</param> /// <param name="inputDataSize">   .</param> /// <param name="outputData"> .</param> /// <param name="outputDataSize">   .</param> /// <param name="outputNeeded">    .</param> /// <param name="status"> .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool XcvData(IntPtr printer, string dataType, IntPtr inputData, uint inputDataSize, IntPtr outputData, uint outputDataSize, out uint outputNeeded, out uint status); /// <summary> ///       <see cref="PortInfo"/>. /// </summary> /// <param name="serverName"> ,      .   null -    .</param> /// <param name="level">  .    1  2.</param> /// <param name="ports">     <see cref="PortInfo"/>.</param> /// <param name="bufferSize">    <see cref="PortInfo"/> ( ).</param> /// <param name="bytesNeeded">    .</param> /// <param name="bufferReturnedLength">  .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool EnumPorts(string serverName, uint level, IntPtr ports, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength); #endregion }

次に、ポートを操作するための機能を導入して、PrintingApiを拡張します。

PrintingApiへのポートメソッドの追加

 /// <summary> ///        . /// </summary> public static Port[] Ports => Port.All; /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="type"> .</param> /// <param name="monitor"> ,    .</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Port OpenPort(string name, string description, PortType type, Monitor monitor, string serverName) { Port port = new Port(name, description, type, monitor); monitor.TryInstall(serverName); return port; } /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="type"> .</param> /// <param name="monitor"> ,    .</param> /// <returns>  .</returns> public Port OpenPort(string name, string description, PortType type, Monitor monitor) => OpenPort(name, description, type, monitor, null); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="type"> .</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Port OpenPort(string name, string description, PortType type, string serverName) => OpenPort(name, description, type, null, serverName); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="type"> .</param> /// <returns>  .</returns> public Port OpenPort(string name, string description, PortType type) => OpenPort(name, description, type, null as string); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="monitor"> ,    .</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Port OpenPort(string name, string description, Monitor monitor, string serverName) => OpenPort(name, description, PortType.Redirected, monitor, serverName); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="monitor"> ,    .</param> /// <returns>  .</returns> public Port OpenPort(string name, string description, Monitor monitor) => OpenPort(name, description, monitor, null); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="monitor"> ,    .</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Port OpenPort(string name, Monitor monitor, string serverName) => OpenPort(name, null, monitor, serverName); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="monitor"> ,    .</param> /// <returns>  .</returns> public Port OpenPort(string name, Monitor monitor) => OpenPort(name, monitor, null); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="type"> .</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Port OpenPort(string name, PortType type, string serverName) => OpenPort(name, null, type, serverName); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="type"> .</param> /// <returns>  .</returns> public Port OpenPort(string name, PortType type) => OpenPort(name, type, null); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Port OpenPort(string name, string description, string serverName) => OpenPort(name, description, null, serverName); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <param name="description"> .</param> /// <returns>  .</returns> public Port OpenPort(string name, string description) => OpenPort(name, description, null as string); /// <summary> ///      . /// </summary> /// <param name="name"> .</param> /// <returns>  .</returns> public Port OpenPort(string name) => OpenPort(name, null as string);

また、TODOの代わりにモニターの削除メソッドにチェックを追加することを忘れないでください：

 IEnumerable<Port> openPorts = Port.All.Where(p => p.Monitor?.Name == Name); foreach (Port openPort in openPorts) openPort.Uninstall(serverName);

これで、コードが機能していることを確認し、次のステップに進むことができます。

印刷ポートを操作するための単体テスト

 /// <summary> ///     <see cref="Port"/>. /// </summary> [TestClass] public class PortTests { /// <summary> ///  . /// </summary> protected const string PortName = "TESTPORT:"; /// <summary> ///  . /// </summary> protected const string PortDescription = "Description for " + PortName; /// <summary> ///  . /// </summary> protected const string MonitorName = "mfilemon"; /// <summary> ///   . /// </summary> protected const string FailedMonitorName = "noexist"; /// <summary> ///    . /// </summary> [TestMethod] public void InstallTest() { Port port = new Port(PortName, PortDescription, MonitorName); port.Install(); Assert.IsTrue(Port.All.Select(p => p.Name).Contains(PortName)); } /// <summary> ///    . /// </summary> [TestMethod] public void UninstallTest() { Port port = new Port(PortName, PortDescription, MonitorName); port.Uninstall(); Assert.IsFalse(Port.All.Select(p => p.Name).Contains(PortName)); } /// <summary> ///        . /// </summary> [TestMethod] public void TryInstallTest() { Port port = new Port(PortName, PortDescription, MonitorName); bool f = port.TryInstall(); Assert.IsTrue(f); Assert.IsTrue(Port.All.Select(p => p.Name).Contains(PortName)); } /// <summary> ///        . /// </summary> [TestMethod] public void TryUninstallTest() { Port port = new Port(PortName, PortDescription, MonitorName); bool f = port.TryUninstall(); Assert.IsTrue(f); Assert.IsFalse(Port.All.Select(p => p.Name).Contains(PortName)); } /// <summary> ///     . /// </summary> [TestMethod] [ExpectedException(typeof(PrintingException))] public void InstallFailedTest() { Port port = new Port(PortName, PortDescription, MonitorName); port.Install(); Assert.IsFalse(Port.All.Select(p => p.Name).Contains(PortName)); } /// <summary> ///         . /// </summary> [TestMethod] public void TryInstallFailedTest() { Port port = new Port(PortName, PortDescription, FailedMonitorName); bool f = port.TryUninstall(); Assert.IsTrue(f); Assert.IsFalse(Port.All.Select(p => p.Name).Contains(PortName)); } }

プリンタードライバー

ドライバーの場合、すべてはモニターの場合とまったく同じです。最初に、ネイティブデータ構造、次にインターフェイス、インターフェイスの実装、API機能の拡張、テストを説明します。最初にドライバーファイルをテストディレクトリにドロップすることを忘れないでください。

struct DriverInfo

 /// <summary> ///         . /// </summary> [StructLayout(LayoutKind.Sequential)] public struct DriverInfo { /// <summary> ///    ,     .   - 3  4 (V3  V4    ). /// </summary> public uint Version; /// <summary> ///   (, "QMS 810"). /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string Name; /// <summary> /// ,      (, Windows x86, Windows IA64  Windows x64). /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string Environment; /// <summary> ///         (, "C:\DRIVERS\Pscript.dll"). /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string DriverPath; /// <summary> ///         (, "C:\DRIVERS\Qms810.ppd"). /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string DataFile; /// <summary> ///      dll    (, "C:\DRIVERS\Pscriptui.dll"). /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string ConfigFile; /// <summary> ///      dll  HLP-  (, "C:\DRIVERS\Pscript.hlp"). /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string HelpFile; /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string DependentFiles; /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string MonitorName; /// <summary> ///     . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string DefaultDataType; }

インターフェースidriver

 /// <summary> ///       . /// </summary> public interface IDriver : IPrintableDevice { /// <summary> ///  . /// </summary> IMonitor Monitor { get; } /// <summary> ///    ,     .   - 3  4 (V3  V4    ). /// </summary> uint Version { get; } /// <summary> /// ,      (, Windows x86, Windows IA64  Windows x64). /// </summary> Environment Environment { get; } /// <summary> ///         (, "C:\DRIVERS\Pscript.dll"). /// </summary> string Dll { get; } /// <summary> ///         (, "C:\DRIVERS\Qms810.ppd"). /// </summary> string DataFile { get; } /// <summary> ///      dll    (, "C:\DRIVERS\Pscriptui.dll"). /// </summary> string ConfigFile { get; } /// <summary> ///      dll  HLP-  (, "C:\DRIVERS\Pscript.hlp"). /// </summary> string HelpFile { get; } /// <summary> ///  . /// </summary> string DependentFiles { get; } /// <summary> ///     . /// </summary> DataType DefaultDataType { get; } }

クラスドライバー

 /// <summary> ///       . /// </summary> public class Driver : PrintableDevice, IDriver { /// <summary> ///  . /// </summary> public virtual IMonitor Monitor { get; protected set; } /// <summary> ///    ,     .   - 3  4 (V3  V4    ). /// </summary> public virtual uint Version { get; protected set; } /// <summary> /// ,     . /// </summary> public virtual Environment Environment { get; protected set; } /// <summary> ///        . /// </summary> public virtual string Dll { get; protected set; } /// <summary> ///        . /// </summary> public virtual string DataFile { get; protected set; } /// <summary> ///      dll   . /// </summary> public virtual string ConfigFile { get; protected set; } /// <summary> ///      dll  HLP- . /// </summary> public virtual string HelpFile { get; protected set; } /// <summary> ///  . /// </summary> public virtual string DependentFiles { get; protected set; } /// <summary> ///     . /// </summary> public virtual DataType DefaultDataType { get; protected set; } /// <summary> ///      . /// </summary> public static string Directory { get; protected set; } /// <summary> ///        . /// </summary> public static Driver[] All { get { if (!PrintingApi.TryGetInfo(EnumPrinterDrivers, 3, out DriverInfo[] driverInfo)) return null; Driver[] drivers = new Driver[driverInfo.Length]; for (int i = 0; i < driverInfo.Length; i++) drivers[i] = new Driver(driverInfo[i].Name, driverInfo[i].DriverPath, driverInfo[i].DataFile, driverInfo[i].ConfigFile, driverInfo[i].HelpFile, driverInfo[i].Version, driverInfo[i].Environment.GetEnvironment(), (DataType)Enum.Parse(typeof(DataType), driverInfo[i].DefaultDataType ?? "RAW", true), driverInfo[i].DependentFiles, driverInfo[i].MonitorName); return drivers; } } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="defaultDataType">    .</param> /// <param name="dependentFiles"> .</param> /// <param name="monitorName">  .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType, string dependentFiles, string monitorName) : base(name) { Dll = dll; DataFile = dataFile; ConfigFile = configFile; HelpFile = helpFile; Version = version; Environment = environment; DefaultDataType = defaultDataType; DependentFiles = dependentFiles; Monitor[] monitors = PrintingApi.Monitors; if (monitors.Select(m => m.Name).Contains(monitorName)) Monitor = monitors.Where(m => m.Name == monitorName).FirstOrDefault(); } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="defaultDataType">    .</param> /// <param name="dependentFiles"> .</param> /// <param name="monitor"> .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType, string dependentFiles, IMonitor monitor) : this(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, monitor?.Name) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="defaultDataType">    .</param> /// <param name="monitorName">  .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType, string monitorName) : this(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, null, monitorName) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="defaultDataType">    .</param> /// <param name="monitor"> .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType, IMonitor monitor) : this(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, monitor?.Name) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="monitorName">  .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, string monitorName) : this(name, dll, dataFile, configFile, helpFile, version, environment, DataType.RAW, monitorName) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="monitor"> .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, IMonitor monitor) : this(name, dll, dataFile, configFile, helpFile, version, environment, monitor?.Name) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="monitorName">  .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, string monitorName) : this(name, dll, dataFile, configFile, helpFile, version, Environment.Current, monitorName) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="monitor"> .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, IMonitor monitor) : this(name, dll, dataFile, configFile, helpFile, version, monitor?.Name) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="monitorName">  .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, string monitorName) : this(name, dll, dataFile, configFile, helpFile, 3, monitorName) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="monitor"> .</param> public Driver(string name, string dll, string dataFile, string configFile, string helpFile, IMonitor monitor) : this(name, dll, dataFile, configFile, helpFile, monitor?.Name) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="monitorName">  .</param> public Driver(string name, string dll, string dataFile, string configFile, string monitorName) : this(name, dll, dataFile, configFile, null, monitorName) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="monitor"> .</param> public Driver(string name, string dll, string dataFile, string configFile, IMonitor monitor) : this(name, dll, dataFile, configFile, monitor?.Name) { } /// <summary> ///     <see cref="Driver"/>. /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> public Driver(string name, string dll, string dataFile, string configFile) : this(name, dll, dataFile, configFile, null as string) { } /// <summary> ///    <see cref="Driver"/>. /// </summary> static Driver() { uint length = 1024; StringBuilder driverDirectory = new StringBuilder((int)length); uint bytesNeeded = 0; if (!GetPrinterDriverDirectory(null, null, 1, driverDirectory, length, ref bytesNeeded)) throw new PrintingException(Marshal.GetLastWin32Error()); Directory = driverDirectory.ToString(); } /// <summary> ///     . /// </summary> /// <param name="serverName"> .</param> public override void Install(string serverName) { try { if (!File.Exists(Dll)) throw new PrintingException($"     '{Dll}'"); if (!File.Exists(DataFile)) throw new PrintingException($"     '{DataFile}'"); if (!File.Exists(ConfigFile)) throw new PrintingException($"     '{ConfigFile}'"); if (All.Select(d => d.Name).Contains(Name)) Uninstall(serverName); string systemDriverPath = Path.Combine(Directory, Path.GetFileName(Dll)); string systemDataPath = Path.Combine(Directory, Path.GetFileName(DataFile)); string systemConfigPath = Path.Combine(Directory, Path.GetFileName(ConfigFile)); string systemHelpPath = Path.Combine(Directory, Path.GetFileName(HelpFile)); File.Copy(Dll, systemDriverPath, true); File.Copy(DataFile, systemDataPath, true); File.Copy(ConfigFile, systemConfigPath, true); if (File.Exists(HelpFile)) File.Copy(HelpFile, systemHelpPath, true); DriverInfo driverInfo = new DriverInfo { Version = Version, Name = Name, Environment = Environment.GetEnvironmentName(), DriverPath = File.Exists(systemDriverPath) ? systemDriverPath : Dll, DataFile = File.Exists(systemDataPath) ? systemDataPath : DataFile, ConfigFile = File.Exists(systemConfigPath) ? systemConfigPath : ConfigFile, HelpFile = File.Exists(systemHelpPath) ? systemHelpPath : HelpFile, DependentFiles = DependentFiles, MonitorName = Monitor?.Name, DefaultDataType = Enum.GetName(typeof(DataType), DefaultDataType), }; if (AddPrinterDriver(serverName, Version, ref driverInfo)) return; int lastWin32ErrorCode = Marshal.GetLastWin32Error(); if (lastWin32ErrorCode == 0) return; throw new PrintingException(lastWin32ErrorCode); } catch (Exception e) { throw new PrintingException(e.Message, e); } } /// <summary> ///     . /// </summary> /// <param name="serverName"> .</param> public override void Uninstall(string serverName) { try { if (!All.Select(d => d.Name).Contains(Name)) return; /// TODO:   ,  . if (DeletePrinterDriver(serverName, Environment.GetEnvironmentName(), Name)) return; throw new PrintingException(Marshal.GetLastWin32Error()); } catch (Exception e) { throw new PrintingException(e.Message, e); } } #region Native /// <summary> ///         . /// </summary> /// <param name="serverName"> ,         .   null -   .</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="level">  .    1.</param> /// <param name="driverDirectory">   .</param> /// <param name="bufferSize">    .</param> /// <param name="bytesNeeded">   .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool GetPrinterDriverDirectory(string serverName, string environment, uint level, [Out] StringBuilder driverDirectory, uint bufferSize, ref uint bytesNeeded); /// <summary> ///    . /// </summary> /// <param name="serverName"> .</param> /// <param name="level">  .    1, 2, 3, 4, 5, 6  8.</param> /// <param name="driverInfo"> .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool AddPrinterDriver(string serverName, uint level, ref DriverInfo driverInfo); /// <summary> ///       <see cref="DriverInfo"/>. /// </summary> /// <param name="serverName"> ,      .   null -    .</param> /// <param name="environment"> (, Windows x86, Windows IA64, Windows x64,  Windows NT R4000).    null, ///     ( ).    "all",       , ///       .</param> /// <param name="level">  .    1, 2, 3, 4, 5, 6  8.</param> /// <param name="drivers">     <see cref="DriverInfo"/>.</param> /// <param name="bufferSize">    <see cref="DriverInfo"/> ( ).</param> /// <param name="bytesNeeded">    .</param> /// <param name="bufferReturnedLength">  .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool EnumPrinterDrivers(string serverName, string environment, uint level, IntPtr drivers, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength); /// <summary> ///    . /// </summary> /// <param name="serverName"> .</param> /// <param name="environment"> (, Windows x86, Windows IA64, Windows x64,  Windows NT R4000).    null, ///     ( ).    "all",       , ///       .</param> /// <param name="driverName"> .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool DeletePrinterDriver(string serverName, string environment, string driverName); #endregion }

ドライバーメソッドでPrintingApiを拡張する

 /// <summary> ///        . /// </summary> public static Driver[] Drivers => Driver.All; /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="defaultDataType">    .</param> /// <param name="dependentFiles"> .</param> /// <param name="monitor"> .</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType, string dependentFiles, Monitor monitor, string serverName) { Driver driver = new Driver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, monitor); driver.TryInstall(serverName); return driver; } /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="defaultDataType">    .</param> /// <param name="dependentFiles"> .</param> /// <param name="monitor"> .</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType, string dependentFiles, Monitor monitor) => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, monitor, null); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="defaultDataType">    .</param> /// <param name="dependentFiles"> .</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType, string dependentFiles, string serverName) => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, null, serverName); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="defaultDataType">    .</param> /// <param name="dependentFiles"> .</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType, string dependentFiles) => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, dependentFiles, null as string); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="defaultDataType">    .</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, DataType defaultDataType) => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, defaultDataType, null); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment, string serverName) => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, DataType.RAW, serverName); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="environment">,      (, Windows x86, Windows IA64  Windows x64).</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, Environment environment) => InstallDriver(name, dll, dataFile, configFile, helpFile, version, environment, null); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version, string serverName) => InstallDriver(name, dll, dataFile, configFile, helpFile, version, Environment.Current, serverName); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="version">   ,     .   - 3  4 (V3  V4    ).</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, uint version) => InstallDriver(name, dll, dataFile, configFile, helpFile, version, null); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile, string serverName) => InstallDriver(name, dll, dataFile, configFile, helpFile, 3, serverName); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <param name="helpFile">     dll  HLP-  (, "C:\DRIVERS\Pscript.hlp").</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile, string helpFile) => InstallDriver(name, dll, dataFile, configFile, helpFile, null); /// <summary> ///     . /// </summary> /// <param name="name"> .</param> /// <param name="dll">        (, "C:\DRIVERS\Pscript.dll").</param> /// <param name="dataFile">        (, "C:\DRIVERS\Qms810.ppd").</param> /// <param name="configFile">     dll    (, "C:\DRIVERS\Pscriptui.dll").</param> /// <returns>  .</returns> public Driver InstallDriver(string name, string dll, string dataFile, string configFile) => InstallDriver(name, dll, dataFile, configFile, null);

モニターの削除方法で、印刷モニターに関連付けられているドライバーの削除を追加します

 IEnumerable<Driver> drivers = Driver.All.Where(d => d.Monitor?.Name == Name); foreach (Driver driver in drivers) driver.Uninstall(serverName);

単体テストを使用したテスト

 /// <summary> ///     <see cref="Driver"/>. /// </summary> [TestClass] public class DriverTests { /// <summary> ///  . /// </summary> protected const string DriverName = "Test Driver"; /// <summary> ///  . /// </summary> protected const string MonitorName = "mfilemon"; /// <summary> ///   . /// </summary> protected const string FailedMonitorName = "noexist"; protected const string DllPath = "D:/Printing Tests/pscript.dll"; protected const string DataPath = "D:/Printing Tests/testprinter.ppd"; protected const string ConfigPath = "D:/Printing Tests/pscriptui.dll"; protected const string HelpPath = "D:/Printing Tests/pscript.hlp"; /// <summary> ///    . /// </summary> [TestMethod] public void InstallTest() { Driver driver = new Driver(DriverName, DllPath, DataPath, ConfigPath, HelpPath, MonitorName); driver.Install(); Assert.IsTrue(Driver.All.Select(d => d.Name).Contains(DriverName)); } /// <summary> ///    . /// </summary> [TestMethod] public void UninstallTest() { Driver driver = new Driver(DriverName, DllPath, DataPath, ConfigPath, HelpPath, MonitorName); driver.Uninstall(); Assert.IsFalse(Driver.All.Select(d => d.Name).Contains(DriverName)); } /// <summary> ///        . /// </summary> [TestMethod] public void TryInstallTest() { Driver driver = new Driver(DriverName, DllPath, DataPath, ConfigPath, HelpPath, MonitorName); bool f = driver.TryInstall(); Assert.IsTrue(f); Assert.IsTrue(Driver.All.Select(d => d.Name).Contains(DriverName)); } /// <summary> ///        . /// </summary> [TestMethod] public void TryUninstallTest() { Driver driver = new Driver(DriverName, DllPath, DataPath, ConfigPath, HelpPath, MonitorName); bool f = driver.TryUninstall(); Assert.IsTrue(f); Assert.IsFalse(Driver.All.Select(d => d.Name).Contains(DriverName)); } /// <summary> ///     . /// </summary> [TestMethod] [ExpectedException(typeof(PrintingException))] public void InstallFailedTest() { Driver driver = new Driver(DriverName, DllPath + "failed", DataPath, ConfigPath, HelpPath, FailedMonitorName); driver.Install(); Assert.IsFalse(Driver.All.Select(d => d.Name).Contains(DriverName)); } /// <summary> ///         . /// </summary> [TestMethod] public void TryInstallFailedTest() { Driver driver = new Driver(DriverName, DllPath + "failed", DataPath, ConfigPath, HelpPath, FailedMonitorName); bool f = driver.TryInstall(); Assert.IsTrue(f); Assert.IsFalse(Driver.All.Select(d => d.Name).Contains(DriverName)); } }

印刷装置

そして、今度は、おそらく、UIと印刷モニターの間の関係を提供する最も重要なコンポーネントであるプリンターを実装するときです。以前の操作との違いもほとんどありません。

struct PrinterInfo

 /// <summary> ///    . /// </summary> [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)] public struct PrinterInfo { /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string ServerName; /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string PrinterName; /// <summary> ///   . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string ShareName; /// <summary> ///  ,   . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string PortName; /// <summary> ///   . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string DriverName; /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string Comment; /// <summary> ///  . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string Location; public IntPtr DevMode; [MarshalAs(UnmanagedType.LPTStr)] public string SepFile; /// <summary> ///  ,   . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string PrintProcessor; /// <summary> ///    . /// </summary> [MarshalAs(UnmanagedType.LPTStr)] public string DataType; [MarshalAs(UnmanagedType.LPTStr)] public string Parameters; public IntPtr SecurityDescriptor; public uint Attributes; public uint Priority; public uint DefaultPriority; public uint StartTime; public uint UntilTime; public uint Status; public uint cJobs; public uint AveragePPM; }

インストールされているプリンターのリストを取得するには、フラグも必要です。

列挙型PrinterEnumFlag

 /// <summary> ///       . /// </summary> [Flags] internal enum PrinterEnumFlag { Default = 0x00000001, Local = 0x00000002, Connections = 0x00000004, Favorite = 0x00000004, Name = 0x00000008, Remote = 0x00000010, Shared = 0x00000020, Network = 0x00000040, Expand = 0x00004000, Container = 0x00008000, IconMask = 0x00ff0000, Icon1 = 0x00010000, Icon2 = 0x00020000, Icon3 = 0x00040000, Icon4 = 0x00080000, Icon5 = 0x00100000, Icon6 = 0x00200000, Icon7 = 0x00400000, Icon8 = 0x00800000, Hide = 0x01000000, All = 0x02000000, Category3D = 0x04000000, }

インターフェイスIPrinter

 /// <summary> ///     . /// </summary> public interface IPrinter : IPrintableDevice { /// <summary> /// ,    . /// </summary> IPort Port { get; } /// <summary> /// ,    . /// </summary> IDriver Driver { get; } /// <summary> ///   . /// </summary> string ShareName { get; } /// <summary> ///  ,    . /// </summary> string ServerName { get; } /// <summary> ///   . /// </summary> string Description { get; } /// <summary> ///  . /// </summary> string Location { get; } string SepFile { get; } /// <summary> ///  . /// </summary> string Parameters { get; } /// <summary> ///   . /// </summary> DataType DataType { get; } }

クラスプリンター

 /// <summary> ///   . /// </summary> public class Printer : PrintableDevice, IPrinter { /// <summary> /// ,    . /// </summary> public virtual IPort Port { get; protected set; } /// <summary> /// ,    . /// </summary> public virtual IDriver Driver { get; protected set; } /// <summary> ///   . /// </summary> public virtual string ShareName { get; protected set; } /// <summary> ///   . /// </summary> public virtual string Description { get; protected set; } /// <summary> ///   . /// </summary> public virtual DataType DataType { get; protected set; } /// <summary> ///   . /// </summary> public virtual string Processor { get; protected set; } /// <summary> ///  ,    . /// </summary> public virtual string ServerName { get; protected set; } /// <summary> ///  . /// </summary> public virtual string Location { get; protected set; } /// <summary> ///  . /// </summary> public virtual string Parameters { get; protected set; } public virtual string SepFile { get; protected set; } /// <summary> ///      . /// </summary> public static Printer Default { get { uint length = 0; if (GetDefaultPrinter(null, ref length)) return null; int lastWin32Error = Marshal.GetLastWin32Error(); if (lastWin32Error != PrintingException.ErrorInsufficientBuffer) throw new PrintingException(lastWin32Error); StringBuilder printerName = new StringBuilder((int)length); if (!GetDefaultPrinter(printerName, ref length)) throw new PrintingException(Marshal.GetLastWin32Error()); string name = printerName.ToString(); return All.Where(p => p.Name == name).FirstOrDefault(); } set { if (!SetDefaultPrinter(value?.Name)) throw new PrintingException(Marshal.GetLastWin32Error()); } } /// <summary> ///      . /// </summary> public static Printer[] All { get { uint bytesNeeded = 0; uint bufferReturnedLength = 0; uint level = 2; PrinterEnumFlag flags = PrinterEnumFlag.Local | PrinterEnumFlag.Network; if (EnumPrinters(flags, null, level, IntPtr.Zero, 0, ref bytesNeeded, ref bufferReturnedLength)) return null; int lastWin32Error = Marshal.GetLastWin32Error(); if (lastWin32Error != PrintingException.ErrorInsufficientBuffer) throw new PrintingException(lastWin32Error); IntPtr printersPtr = Marshal.AllocHGlobal((int)bytesNeeded); try { if (EnumPrinters(flags, null, level, printersPtr, bytesNeeded, ref bytesNeeded, ref bufferReturnedLength)) { IntPtr currentPrinterPtr = printersPtr; PrinterInfo[] printerInfo = new PrinterInfo[bufferReturnedLength]; Printer[] printers = new Printer[bufferReturnedLength]; Type type = typeof(PrinterInfo); for (int i = 0; i < bufferReturnedLength; i++) { printerInfo[i] = (PrinterInfo)Marshal.PtrToStructure(currentPrinterPtr, type); currentPrinterPtr = (IntPtr)(currentPrinterPtr.ToInt64() + Marshal.SizeOf(type)); printers[i] = new Printer(printerInfo[i].PrinterName, printerInfo[i].PortName, printerInfo[i].DriverName, printerInfo[i].PrintProcessor, printerInfo[i].ShareName, printerInfo[i].ServerName, printerInfo[i].Comment, (DataType)Enum.Parse(typeof(DataType), printerInfo[i].DataType), printerInfo[i].Location, printerInfo[i].Parameters, printerInfo[i].SepFile); } return printers; } throw new PrintingException(Marshal.GetLastWin32Error()); } catch { return null; } finally { Marshal.FreeHGlobal(printersPtr); } } } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="portName"> .</param> /// <param name="driverName"> .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <param name="location"> .</param> /// <param name="parameters"> .</param> /// <param name="sepFile"></param> public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description, DataType dataType, string location, string parameters, string sepFile) : base(name) { Port[] ports = PrintingApi.Ports; Driver[] drivers = PrintingApi.Drivers; if (ports.Select(p => p.Name).Contains(portName)) Port = ports.Where(p => p.Name == portName).FirstOrDefault(); if (drivers.Select(d => d.Name).Contains(driverName)) Driver = drivers.Where(d => d.Name == driverName).FirstOrDefault(); Processor = processorName; ShareName = shareName; ServerName = serverName; Description = description; DataType = dataType; Location = location; Parameters = parameters; SepFile = sepFile; } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <param name="location"> .</param> /// <param name="parameters"> .</param> /// <param name="sepFile"></param> public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description, DataType dataType, string location, string parameters, string sepFile) : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description, dataType, location, parameters, sepFile) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="portName"> .</param> /// <param name="driverName"> .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <param name="location"> .</param> /// <param name="parameters"> .</param> public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description, DataType dataType, string location, string parameters) : this(name, portName, driverName, processorName, shareName, serverName, description, dataType, location, parameters, null) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <param name="location"> .</param> /// <param name="parameters"> .</param> public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description, DataType dataType, string location, string parameters) : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description, dataType, location, parameters) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="portName"> .</param> /// <param name="driverName"> .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <param name="location"> .</param> public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description, DataType dataType, string location) : this(name, portName, driverName, processorName, shareName, serverName, description, dataType, location, null) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <param name="location"> .</param> public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description, DataType dataType, string location) : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description, dataType, location) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="portName"> .</param> /// <param name="driverName"> .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description, DataType dataType) : this(name, portName, driverName, processorName, shareName, serverName, description, dataType, null) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description, DataType dataType) : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description, dataType) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="portName"> .</param> /// <param name="driverName"> .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName, string description) : this(name, portName, driverName, processorName, shareName, serverName, description, DataType.RAW) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName, string description) : this(name, port?.Name, driver?.Name, processorName, shareName, serverName, description) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="portName"> .</param> /// <param name="driverName"> .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> public Printer(string name, string portName, string driverName, string processorName, string shareName, string serverName) : this(name, portName, driverName, processorName, shareName, serverName, null) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> public Printer(string name, IPort port, IDriver driver, string processorName, string shareName, string serverName) : this(name, port?.Name, driver?.Name, processorName, shareName, serverName) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="portName"> .</param> /// <param name="driverName"> .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> public Printer(string name, string portName, string driverName, string processorName, string shareName) : this(name, portName, driverName, processorName, shareName, null) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> public Printer(string name, IPort port, IDriver driver, string processorName, string shareName) : this(name, port?.Name, driver?.Name, processorName, shareName) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="portName"> .</param> /// <param name="driverName"> .</param> /// <param name="processorName">  .</param> public Printer(string name, string portName, string driverName, string processorName) : this(name, portName, driverName, processorName, null) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> public Printer(string name, IPort port, IDriver driver, string processorName) : this(name, port?.Name, driver?.Name, processorName) { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="portName"> .</param> /// <param name="driverName"> .</param> public Printer(string name, string portName, string driverName) : this(name, portName, driverName, "WinPrint") { } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> public Printer(string name, IPort port, IDriver driver) : this(name, port?.Name, driver?.Name) { } /// <summary> ///    . /// </summary> /// <param name="serverName"> .</param> public override void Install(string serverName) { try { if (All.Select(p => p.Name).Contains(Name)) Uninstall(serverName); PrinterInfo printerInfo = new PrinterInfo { ServerName = serverName, PrinterName = Name, ShareName = ShareName, PortName = Port?.Name, DriverName = Driver?.Name, Comment = Description, Location = Location, DevMode = new IntPtr(0), SepFile = SepFile, PrintProcessor = Processor, DataType = Enum.GetName(typeof(DataType), DataType), Parameters = Parameters, SecurityDescriptor = new IntPtr(0), }; if (AddPrinter(serverName, 2, ref printerInfo)) return; int lastWin32ErrorCode = Marshal.GetLastWin32Error(); if (lastWin32ErrorCode == 0) return; throw new PrintingException(lastWin32ErrorCode); } catch (Exception e) { throw new PrintingException(e.Message, e); } } /// <summary> ///    . /// </summary> /// <param name="serverName"> .</param> public override void Uninstall(string serverName) { try { if (!All.Select(p => p.Name).Contains(Name)) return; PrinterDefaults defaults = new PrinterDefaults { DesiredAccess = PrinterAccess.PrinterAllAccess }; if (!NET.Port.OpenPrinter(Name, out IntPtr printerHandle, ref defaults)) throw new PrintingException(Marshal.GetLastWin32Error()); if (!DeletePrinter(printerHandle)) { int lastWin32ErrorCode = Marshal.GetLastWin32Error(); if (lastWin32ErrorCode == PrintingException.ErrorInvalidPrinterName) return; throw new PrintingException(lastWin32ErrorCode); } NET.Port.ClosePrinter(printerHandle); } catch (Exception e) { throw new PrintingException(e.Message, e); } } #region Native /// <summary> ///    . /// </summary> /// <param name="serverName"> .</param> /// <param name="level"> .</param> /// <param name="printerInfo"> .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true, CallingConvention = CallingConvention.StdCall)] internal static extern bool AddPrinter(string serverName, uint level, [In] ref PrinterInfo printerInfo); /// <summary> ///   ,     . /// </summary> /// <param name="printerName"> .</param> /// <param name="bytesNeeded">   .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool GetDefaultPrinter([Out] StringBuilder printerName, ref uint bytesNeeded); /// <summary> ///     . /// </summary> /// <param name="printerName">    .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool SetDefaultPrinter(string printerName); /// <summary> ///      . /// </summary> /// <param name="flags">   .</param> /// <param name="serverName"> .</param> /// <param name="level"> .</param> /// <param name="printers">   .</param> /// <param name="bufferSize"> .</param> /// <param name="bytesNeeded">       .</param> /// <param name="bufferReturnedLength">  .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true)] internal static extern bool EnumPrinters(PrinterEnumFlag flags, string serverName, uint level, IntPtr printers, uint bufferSize, ref uint bytesNeeded, ref uint bufferReturnedLength); /// <summary> ///    . /// </summary> /// <param name="printer">  .</param> /// <returns>True,    ,  False.</returns> [DllImport("winspool.drv", CharSet = CharSet.Auto, SetLastError = true, CallingConvention = CallingConvention.StdCall)] internal static extern bool DeletePrinter(IntPtr printer); #endregion }

印刷Apiの拡大

 /// <summary> ///        . /// </summary> public static Printer[] Printers => Printer.All; /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <param name="location"> .</param> /// <param name="parameters"> .</param> /// <param name="sepFile"></param> /// <returns>  .</returns> public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description, DataType dataType, string location, string parameters, string sepFile) { Printer printer = new Printer(name, port, driver, processorName, shareName, serverName, description, dataType, location, parameters, sepFile); printer.TryInstall(serverName); return printer; } /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <param name="location"> .</param> /// <param name="parameters"> .</param> /// <returns>  .</returns> public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description, DataType dataType, string location, string parameters) => RunPrinter(name, port, driver, processorName, shareName, serverName, description, dataType, location, parameters, null); /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <param name="location"> .</param> /// <returns>  .</returns> public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description, DataType dataType, string location) => RunPrinter(name, port, driver, processorName, shareName, serverName, description, dataType, location, null); /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <param name="dataType">  .</param> /// <returns>  .</returns> public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description, DataType dataType) => RunPrinter(name, port, driver, processorName, shareName, serverName, description, dataType, null); /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <param name="description"> .</param> /// <returns>  .</returns> public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName, string description) => RunPrinter(name, port, driver, processorName, shareName, serverName, description, DataType.RAW); /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <param name="serverName"> .</param> /// <returns>  .</returns> public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName, string serverName) => RunPrinter(name, port, driver, processorName, shareName, serverName, null); /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <param name="shareName">  .</param> /// <returns>  .</returns> public Printer RunPrinter(string name, Port port, Driver driver, string processorName, string shareName) => RunPrinter(name, port, driver, processorName, shareName, null); /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <param name="processorName">  .</param> /// <returns>  .</returns> public Printer RunPrinter(string name, Port port, Driver driver, string processorName) => RunPrinter(name, port, driver, processorName, null); /// <summary> ///     <see cref="Printer"/>. /// </summary> /// <param name="name"> .</param> /// <param name="port">,    .</param> /// <param name="driver">,    .</param> /// <returns>  .</returns> public Printer RunPrinter(string name, Port port, Driver driver) => RunPrinter(name, port, driver, "WinPrint");

接続されているすべてのプリンターの削除を、削除するポートとドライバーに追加します

 IEnumerable<Printer> printers = Printer.All.Where(p => p.Driver?.Name == Name); foreach (Printer printer in printers) printer.Uninstall(serverName);

テスト中

 /// <summary> ///     <see cref="Printer"/>. /// </summary> [TestClass] public class PrinterTests { /// <summary> ///  . /// </summary> protected const string PrinterName = "Test Printer"; /// <summary> ///  . /// </summary> protected const string PortName = "TESTPORT:"; /// <summary> ///  . /// </summary> protected const string DriverName = "Test Driver"; /// <summary> ///    . /// </summary> [TestMethod] public void InstallTest() { Printer printer = new Printer(PrinterName, PortName, DriverName); printer.Install(); Assert.IsTrue(Printer.All.Select(p => p.Name).Contains(PrinterName)); } /// <summary> ///    . /// </summary> [TestMethod] public void UninstallTest() { Printer printer = new Printer(PrinterName, PortName, DriverName); printer.Uninstall(); Assert.IsFalse(Printer.All.Select(p => p.Name).Contains(PrinterName)); } /// <summary> ///        . /// </summary> [TestMethod] public void TryInstallTest() { Printer printer = new Printer(PrinterName, PortName, DriverName); bool f = printer.TryInstall(); Assert.IsTrue(f); Assert.IsTrue(Printer.All.Select(p => p.Name).Contains(PrinterName)); } /// <summary> ///        . /// </summary> [TestMethod] public void TryUninstallTest() { Printer printer = new Printer(PrinterName, PortName, DriverName); bool f = printer.TryUninstall(); Assert.IsTrue(f); Assert.IsFalse(Printer.All.Select(p => p.Name).Contains(PrinterName)); } }

システムの変更を有効にするには、プリンターをインストールした後、印刷サービスを手動で再起動する必要があります。Spoolerを起動/再起動する静的メソッドをPrintingApiクラスに記述します。これは、コンピューターの印刷サービスが最初に停止された場合にも当てはまります。

 /// <summary> ///   . /// </summary> /// <returns>True,    ,  False.</returns> public static bool TryRestart() { int tryCount = 5; while (tryCount > 0) { try { ServiceController sc = new ServiceController("Spooler"); if (sc.Status != ServiceControllerStatus.Stopped || sc.Status != ServiceControllerStatus.StopPending) { sc.Stop(); sc.WaitForStatus(ServiceControllerStatus.Stopped); } sc.Start(); sc.WaitForStatus(ServiceControllerStatus.Running); return sc.Status == ServiceControllerStatus.Running; } catch { tryCount--; } } return false; }

System.ServiceProcess.dllへのリンクをプロジェクトに接続する必要があります。すべてが単純です：サービスコントローラーを起動し、ステータスを確認し、開始されている場合は停止し、停止するまで待機してから、エラーが発生した場合（たとえば、サービスが現在ビジーである場合）、開始してステータスが「開始」に変わるまで待機し、手順4を繰り返します回。

この上で、印刷デバイスを操作するための基本機能は準備ができていると考えることができます。そのため、現時点でAPIでできること：

インストールされたモニター、ドライバー、開いているポート、実行中のプリンターのコレクションを取得します。
新しいモニターをインストールします。そのようなモニターが既にインストールされている場合は、再インストールします。
モニターを取り外します。モニターでポートが開いている場合、またはドライバーが接続されている場合は、まずそれらも削除します。
新しいポートを開きます。そのようなポートがすでに開いている場合は、再度開きます。
ポートを閉じます。ポートにプリンターが接続されている場合は、最初にプリンターを切断します。
プリンタードライバーをインストールします。ドライバが既にインストールされている場合-再インストールします。
プリンタードライバーをアンインストールします。ドライバーがプリンターによって使用される場合-最初にそれらを無効にします。
プリンターを起動します。指定された名前のプリンターが既に実行されている場合-再起動します。
プリンターの電源を切ります。
CLRおよびWin32エラーをキャッチします。
印刷サービスを再起動します。

PrintingApiクラスの最後の一般的なテストを行い、記事の最後の部分に進みます。

印刷デバイスのすべてのコンポーネントの順次インストールを確認する単体テスト

 [TestClass] public class PrintingApiTests { protected const string MonitorName = "mfilemon"; protected const string PortName = "TESTPORT:"; protected const string DriverName = "Test Driver"; protected const string PrinterName = "Test Printer"; protected const string MonitorFile = "D:/Printing Tests/mfilemon.dll"; protected const string DriverFile = "D:/Printing Tests/pscript5.dll"; protected const string DriverDataFile = "D:/Printing Tests/testprinter.ppd"; protected const string DriverConfigFile = "D:/Printing Tests/ps5ui.dll"; protected const string DriverHelpFile = "D:/Printing Tests/pscript.hlp"; [TestMethod] public void PrinterInstallationTest() { PrintingApi.TryRestart(); Monitor monitor = PrintingApi.Factory.CreateMonitor(MonitorName, MonitorFile); Port port = PrintingApi.Factory.OpenPort(PortName, monitor); Driver driver = PrintingApi.Factory.InstallDriver(DriverName, DriverFile, DriverDataFile, DriverConfigFile, DriverHelpFile, 3, Environment.Current, DataType.RAW, null, monitor); Printer printer = PrintingApi.Factory.RunPrinter(PrinterName, port, driver); PrintingApi.TryRestart(); Assert.IsNotNull(printer); } }

, Spooler , , API , STA- UI.

, . , . , mfilemon.dll :

 string monitorName = "mfilemon"; string portName = "TESTPORT:"; string keyName = $"SYSTEM\\CurrentControlSet\\Control\\Print\\Monitors\\{monitorName}\\{portName}"; Registry.LocalMachine.CreateSubKey(keyName); using (RegistryKey regKey = Registry.LocalMachine.OpenSubKey(keyName, true)) { regKey.SetValue("OutputPath", "D:/Printing Tests/", RegistryValueKind.String); regKey.SetValue("FilePattern", "%r_%c_%u_%Y%m%d_%H%n%s_%j.ps", RegistryValueKind.String); regKey.SetValue("Overwrite", 0, RegistryValueKind.DWord); regKey.SetValue("UserCommand", string.Empty, RegistryValueKind.String); regKey.SetValue("ExecPath", string.Empty, RegistryValueKind.String); regKey.SetValue("WaitTermination", 0, RegistryValueKind.DWord); regKey.SetValue("PipeData", 0, RegistryValueKind.DWord); }

これで、「D：/ Printing Tests /」ディレクトリにページ記述の既に生成されたPostScriptファイルが表示されます。少なくともテキスト形式またはPDFに変換し、古い方法で解析（God forbid）またはGhostScriptツールを使用して、サーバーに転送し、少なくともメモリにロードします。印刷後にファイルが作成された瞬間を傍受するためだけに残っています。このため、System.IOクラスはFileSystemWatcherクラスを提供します。これはファイルシステムの状態を監視し、イベントハンドラーを呼び出すことができます。

 // ,        ,   ,       . FileSystemWatcher fileSystemWatcher = new FileSystemWatcher("D:/Printing Tests/", "*.ps") { NotifyFilter = NotifyFilters.DirectoryName }; fileSystemWatcher.NotifyFilter = fileSystemWatcher.NotifyFilter | NotifyFilters.FileName; fileSystemWatcher.NotifyFilter = fileSystemWatcher.NotifyFilter | NotifyFilters.Attributes; fileSystemWatcher.Created += new FileSystemEventHandler(PrinterHandler); //     . try { fileSystemWatcher.EnableRaisingEvents = true; //  . } catch (ArgumentException e) { }

イベントハンドラは次のようになります。

 void PrinterHandler(object sender, FileSystemEventArgs e) { //    . switch (e.ChangeType) { //   .          ,  . case WatcherChangeTypes.Created: try { // TODO:      ,    -   ( ). byte[] fileData = File.ReadAllBytes(e.FullPath); //        ,          . //      . File.Delete(e.FullPath); //        ,     . } catch (Exception ex) { } break; } }

実際、これで私たちのタスクは完全に解決されたと考えることができます。

おわりに

いつものように、私はこの記事で何かをするふりをしません。今日、私は「特定の」問題に対する解決策を「指で」説明しようとしました（ただし、過去数年の経験-それでも関連性があります）は、私にとってできるだけわかりやすく詳細なC＃言語によって解決されました。この記事がお役に立てば幸いです。時間を無駄にしないでください。

上記の資料は、スプーラー印刷サービスの動作の基本的な理解だけでなく、ほとんどすべての複雑さのアンマネージコードで高レベルのヘルパーを作成するのに十分なはずです。

おそらく、私はこのプロジェクトを引き続きサポートし、プリントプロセッサでの作業、プリントキューの処理などの可能性を認識します。プロジェクトのユニットテストが添付されたソースコードは、こちらにあります。。プロジェクトで使用するNuGetパッケージは、こちらから入手できます。ここからユニバーサルPPD（および仮想モニタードライバー）をダウンロードします。

ご清聴ありがとうございました！

仮想プリンターの実装例を使用してC＃で印刷デバイスを操作する