IDebugDataSpaces::ReadProcessorSystemData メソッド (dbgeng.h)
ReadProcessorSystemData メソッドは、指定されたプロセッサに関するデータを返します。
構文
HRESULT ReadProcessorSystemData(
[in] ULONG Processor,
[in] ULONG Index,
[out] PVOID Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG DataSize
);
パラメーター
[in] Processor
データを読み取るプロセッサを指定します。
[in] Index
読み取るデータ型を指定します。 次の表に、有効な値を示します。 正常に完了すると、バッファー Buffer に返されるデータは、中央の列で指定された型になります。
価値 | 形容 |
---|---|
DEBUG_DATA_KPCR_OFFSET |
プロセッサのプロセッサ制御領域 (PCR) の仮想アドレスを返します。
この場合、Buffer 引数は型PULONG64を持つと見なすことができます。 |
DEBUG_DATA_KPRCB_OFFSET |
プロセッサのプロセッサ制御ブロック (PRCB) の仮想アドレスを返します。
この場合、Buffer 引数は型PULONG64を持つと見なすことができます。 |
DEBUG_DATA_KTHREAD_OFFSET |
プロセッサで実行されているシステム スレッドの KTHREAD 構造体の仮想アドレスを返します。
この場合、Buffer 引数は型PULONG64を持つと見なすことができます。 |
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET |
オペレーティング システムまたはプロセッサが所有するページング情報のベースの仮想アドレスを返します。 アドレスとアドレスの内容は、プロセッサとオペレーティング システムに依存します。
この場合、Buffer 引数は型PULONG64を持つと見なすことができます。 |
DEBUG_DATA_PROCESSOR_IDENTIFICATION |
プロセッサの説明を返します。
この場合、Buffer 引数は型PDEBUG_PROCESSOR_IDENTIFICATION_ALLを持つと見なすことができます。 |
DEBUG_DATA_PROCESSOR_SPEED |
プロセッサの速度を MHz で返します。 これは、特定のセッションでは機能しない可能性があります。
この場合、Buffer 引数は PULONG 型と見なすことができます。 |
[out] Buffer
プロセッサ データを受信します。 メソッドが正常に完了すると、このバッファーの内容は、上記の表で指定された型 Buffer キャストすることによってアクセスできます。
[in] BufferSize
バッファー バッファーのサイズをバイト単位で指定します。 これは、返される最大バイト数です。
[out, optional] DataSize
データのサイズをバイト単位で受け取ります。 DataSize が NULL 場合、この情報は返されません。
戻り値
リターン コード | 形容 |
---|---|
|
メソッドが成功しました。 |
このメソッドは、エラー値を返すこともできます。 詳細については 戻り値の を参照してください。
備考
このメソッドは、カーネル モードデバッグでのみ使用できます。
PCR、PRCB、KTHREAD 構造体の詳細とページング テーブルに関する情報については、David ソロモンと Mark Russinovich による Microsoft Windows Internals を参照してください。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | dbgeng.h (Dbgeng.h を含む) |