JSConstraintsDebug

[アーティクル]
03/19/2024

JSConstraintsDebug (JSConstraintsDebug.exe) は、V4 プリンタードライバーの開発中に JavaScript の制約のデバッグサポートを提供するコマンドラインツールです。

JSConstraintsDebug はどこでダウンロードできますか?
JSConstraintsDebug.exe は、Microsoft Windows Driver Kit (WDK) に含まれています。 WDK の入手については、「Windows Driver Kit のダウンロード」を参照してください。

このツールは、ユーザー指定のプリントチケットに対して、対象のドライバーの JavaScript 制約に対して、次の関連するエントリポイント API をそれぞれ実行します。

PTGetPrintCapabilities

PTConvertDevModeToPrintTicket

TConvertPrintTicketToDevMode

PTMergeAndValidatePrintTicket

実行中、ツールは Visual Studio などの適切な IDE デバッガーを要求します。選択すると、制約ソースコードが開き、JavaScript デバッガーステートメントで停止します。

JS 制約ファイルをデバッグするには、次の手順に従います。

コマンドプロンプトウィンドウを開きます。
JSConstraintsDebug.exe ツールを実行し、少なくともプリンター名とテストプリントチケットのパスを指定します。
使用するデバッグツールを選択します。

ユーザーモードで JSConstraintsDebug の実行

JS 関数のデバッグを有効にするには、昇格された特権が必要です。ユーザーモードで実行するには、JSConstraintsDebug.exe を実行する前に、次のレジストリキーを設定する必要があります。

キー名	HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print
値の名前	EnableJavaScriptDebugging
Type	DWORD
値	1

JavaScript デバッガーステートメント

ブレークポイントは、デバッガーステートメントを使用して JavaScript ソースで作成できます。これにより、Visual Studio での操作がすべて一時停止され、詳細なデバッグが可能になります。これらのステートメントは、任意の JavaScript 制約 API JavaScript Constraint に挿入できます。

次に例を示します。

function validatePrintTicket(PrintTicket, scriptContext)
{
    debugger; // debug tool will pause at this breakpoint
    ...
}