PIX が起動する子プロセス (WinPixServices、WinPixEngineHost など) からドレインされた stdout/stderr 出力のシンクを登録 (またはクリア) します。 ドレインされた各行は、SourceType を PIX_LOGGING_SOURCE_STD_OUTPUT または PIX_LOGGING_SOURCE_STD_ERROR に設定し、SourceName を生成プロセス ID (10 進数) に設定し、SourceInterface を GUID_NULL に設定して、Message を書式設定されていない生の行コンテンツに設定して、 IPixLogging::ReportLog を介して配信されます。 水切りは、シンクが登録されているかどうかに関係なく、常に pixapi.dll の内部で流れているため、子供のパイプがいっぱいになるのを防ぎます。 logger を nullptr に設定すると、以前に登録されたシンクが切り離され、ドレインされたラインが破棄されます。 いつでも呼び出すことができます。新しいシンクは、後続のラインの水切り糸によって観察されます。 IPixLogging::ReportLog への呼び出しは、任意の pixapi ワーカー スレッドから実行されます。
構文
HRESULT SetLogger(
IPixLogging * logger);
パラメーター
logger [in]
クリアするシンクまたは nullptr。
戻り値
成功のS_OK。
解説
注
指定された IPixLogging 実装は、フリー スレッド (アジャイル) である必要があります。 ReportLog は、COM 初期化されていない pixapi 内部ドレナー スレッドから直接呼び出されます。[local] と宣言されている IPixLogging (マーシャリング プロキシは生成されません) と組み合わせると、アパートメント間で呼び出しをマーシャリングするためのパスはありません。 ReportLog が任意のスレッドから同時に呼び出すのに安全ではない実装は、競合またはクラッシュします。