InitializeCriticalSectionAndSpinCount 関数 (synchapi.h)

[アーティクル]
02/05/2024

クリティカルセクションオブジェクトを初期化し、クリティカルセクションのスピン数を設定します。スレッドがロックされているクリティカルセクションを取得しようとすると、スレッドは スピンします。スピンカウント時間を繰り返すループに入り、ロックが解放されているかどうかを確認します。ループが終了する前にロックが解除されない場合、スレッドはスリープ状態になり、ロックが解放されるまで待機します。

構文

BOOL InitializeCriticalSectionAndSpinCount(
  [out] LPCRITICAL_SECTION lpCriticalSection,
  [in]  DWORD              dwSpinCount
);

パラメーター

[out] lpCriticalSection

クリティカルセクションオブジェクトへのポインター。

[in] dwSpinCount

クリティカルセクションオブジェクトのスピンカウント。単一プロセッサシステムでは、スピン数は無視され、クリティカルセクションのスピン数は 0 (ゼロ) に設定されます。マルチプロセッサシステムでは、クリティカルセクションが使用できない場合、呼び出し元のスレッドは dwSpinCount 回スピンしてから、クリティカルセクションに関連付けられているセマフォに対して待機操作を実行します。スピン操作中にクリティカルセクションが解放されると、呼び出し元スレッドは待機操作を回避します。

戻り値

この関数は常に成功し、0 以外の値を返します。

Windows Server 2003 および Windows XP: 関数が成功した場合、戻り値は 0 以外です。関数が失敗した場合、戻り値は 0 です 0。詳細なエラー情報を得るには、GetLastError を呼び出します。 Windows Vista 以降では、メモリ不足の状況でも InitializeCriticalSectionAndSpinCount 関数は常に成功します。

注釈

1 つのプロセスのスレッドは、相互排他同期にクリティカルセクションオブジェクトを使用できます。スレッドがクリティカルセクションの所有権を取得する順序に関する保証はありません。ただし、システムはすべてのスレッドに対して公平です。

このプロセスは、クリティカルセクションオブジェクトによって使用されるメモリを割り当てる役割を担います。これは、 CRITICAL_SECTION型の変数を宣言することによって実行できます。クリティカルセクションを使用する前に、プロセスの一部のスレッドでオブジェクトを初期化する必要があります。その後、 SetCriticalSectionSpinCount 関数を呼び出してスピン数を変更できます。

クリティカルセクションオブジェクトが初期化されると、プロセスのスレッドは、EnterCriticalSection、 TryEnterCriticalSection、または LeaveCriticalSection 関数でオブジェクトを指定して、共有リソースへの相互排他アクセスを提供できます。異なるプロセスのスレッド間で同様の同期を行う場合は、ミューテックスオブジェクトを使用します。

クリティカルセクションオブジェクトを移動またはコピーすることはできません。また、プロセスはオブジェクトを変更する必要はありませんが、論理的に不透明として扱う必要があります。クリティカルセクションオブジェクトを管理するには、クリティカルセクション関数のみを使用します。クリティカルセクションの使用が完了したら、 DeleteCriticalSection 関数を呼び出します。

クリティカルセクションオブジェクトは、再初期化する前に削除する必要があります。既に初期化されているクリティカルセクションを初期化すると、未定義の動作が発生します。

スピン数は、高レベルの競合が発生する可能性がある短い期間の重要なセクションに役立ちます。 SMP システム上のアプリケーションに 2 つまたは 3 つのスレッドが常にメモリを割り当て、ヒープから解放する最悪のシナリオを考えてみましょう。アプリケーションは、クリティカルセクションを使用してヒープをシリアル化します。最悪のシナリオでは、クリティカルセクションの競合は一定であり、各スレッドは WaitForSingleObject 関数に対して処理集中型の呼び出しを行います。ただし、スピン数が正しく設定されている場合、競合が発生したときに呼び出し元のスレッドは WaitForSingleObject を すぐに呼び出しません。代わりに、呼び出し元のスレッドは、スピン操作中に解放された場合、クリティカルセクションの所有権を取得できます。

短い期間のクリティカルセクションに対して小さなスピン数を選択することで、パフォーマンスを大幅に向上させることができます。たとえば、ヒープマネージャーは、ヒープごとのクリティカルセクションに約 4,000 のスピンカウントを使用します。

この関数を使用するアプリケーションをコンパイルするには、 _WIN32_WINNT を以降として 0x0403 定義します。詳細については、「 Windows ヘッダーの使用」を参照してください。

例

InitializeCriticalSectionAndSpinCount を使用する例については、「クリティカルセクションオブジェクトの使用」を参照してください。

要件


サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	synchapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2 の Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

InitializeCriticalSectionAndSpinCount 関数 (synchapi.h)

構文

パラメーター

戻り値

注釈

例

要件

関連項目

フィードバック

フィードバック

その他のリソース