NdisAcquireSpinLock マクロ (ndis.h)

[アーティクル]
08/07/2023

NdisAcquireSpinLock 関数はスピンロックを取得するため、呼び出し元は、スピンロックが保護するドライバー関数間で共有されるリソースへの排他的アクセスを取得します。

構文

void NdisAcquireSpinLock(
  [in]  _SpinLock
);

パラメーター

[in] _SpinLock

呼び出し元によって既に初期化されている不透明なスピンロックへのポインター。

戻り値

なし

解説

ドライバーは、他の Ndis XxxSpinLock 関数を呼び出す前に、NdisAllocateSpinLock を使用してNDIS_SPIN_LOCK型の変数を初期化する必要があります。ドライバーは、使用するスピンロックの常駐ストレージを提供する必要があります。

NdisAcquireSpinLock を使用してスピンロックを取得した後、呼び出し元は NdisReleaseSpinLock の呼び出しでそのロックを解放する必要があります。ドライバーは 、NdisAcquireSpinLock の各呼び出しの後に NdisReleaseSpinLock を呼び出す必要があります。それ以外の場合は、ドライバーがハングしてデッドロックが発生します。

NdisAcquireSpinLock で取得したスピンロックは、NdisReleaseSpinLock で解放する必要があります。 NdisDprAcquireSpinLock で取得したスピンロックは、NdisDprReleaseSpinLock で解放する必要があります。

ドライバーは、長期間にわたってスピンロックを保持しないでください (いくつかの手順を超える)。スピンロックを 25 マイクロ秒より長く保持すると、システムとドライバーの両方のパフォーマンスが低下します。

ミニポートドライバーは、スピンロックを使用して、その他の関数が MiniportInterrupt および/またはと共有するリソースを保護することはできません MiniportDisableInterruptEx 関数。代わりに、ミニポートドライバーは NdisMSynchronizeWithInterruptEx を呼び出す必要があります。 MiniportSynchronizeInterrupt 関数は、同じ DIRQL でこのような共有リソースにアクセスします。
MiniportInterrupt 関数および /または MiniportDisableInterruptEx 関数を使用します。

NDIS スピンロックの取得と解放の詳細については、「ネットワークドライバーでの同期と通知」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisAcquireSpinLock (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisAcquireSpinLock (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_Synch_Function(ndis)、 SpinLock(ndis)、 SpinLockBalanced(ndis)、 SpinLockDpr(ndis)、 SpinLockDprRelease(ndis)、 SpinlockRelease(ndis)