XtfCaptureOutputBegin
デバッグ出力のキャプチャを開始します。Syntax
Parameters
address型: PCWSTR [in] コンソールの IP アドレスです。 debugStringCallback
型: XtfDebugStringCallback [in, optional] 出力デバッグ文字列ごとに呼び出される、省略可能なコールバックです。 debugStringErrorCallback
型: XtfDebugStringErrorCallback [in, optional] 発生したエラーごとに呼び出される、省略可能なコールバックです。 context
型: PVOID [in, optional] コールバック関数に渡されるオブジェクトへのポインターです。このオブジェクトにより、各コールバックの呼び出しをこのキャプチャ セッションに関連付けることができます。 hListen
型: PHANDLE [out] このキャプチャ セッションを表すハンドルです。
Return value
なし。Remarks
この関数と XtfCaptureOutputEnd 関数を使用して、開発機からの一般的なデバッグ出力のキャプチャを開始および停止します。開発機の特定のプロセス ID からのデバッグ出力を監視する場合は、デバッグ モニター クライアントを使用してください。デバッグ モニター クライアントの使用方法の詳細については、XtfCreateDebugMonitorClient を参照してください。 キャプチャ セッションでデバッグ文字列をキャプチャするには、debugStringCallback に XtfDebugStringCallback 関数を実装して指定する必要があります。同様に、キャプチャ セッション中に発生したエラーをキャプチャするには、debugStringErrorCallback に XtfDebugStringErrorCallback 関数を実装して指定する必要があります。ただし、どちらのコールバック関数も必須ではありません。
デバッグ出力のキャプチャを停止し、キャプチャ セッションに関連付けられたリソースを解放するには、XtfCaptureOutputEnd を呼び出し、そのキャプチャ セッションに対して hListen で返されたハンドルを指定します。
キャプチャ セッションを停止するには、
XtfCaptureOutputEnd を呼び出す必要があります。呼び出さない場合、キャプチャ セッションは孤立し、それに関連付けられたリソースが解放されないため、メモリ リークが発生します。Requirements
ヘッダー: xtfapi.h ライブラリ: XtfApi.lib サポートされているプラットフォーム: Windows (XBOX コンソール ツール用)See also
IXtfDebugMonitorClient InterfaceXTF Transport Errors (NDA topic)
Additional Xtf APIs