NdisDprAcquireSpinLock マクロ (ndis.h)

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

NdisDprAcquireSpinLock 関数は、呼び出し元がマルチプロセッサセーフな方法で ISR 以外のドライバー関数間で共有されているリソースへのアクセスを同期できるように、スピンロックを取得します。

構文

void NdisDprAcquireSpinLock(
  [in]  _SpinLock
);

パラメーター

[in] _SpinLock

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

戻り値

なし

解説

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

NdisDprAcquireSpinLock は、ミニポートドライバーが IRQL = DISPATCH_LEVELで実行中にのみ呼び出すことができる NdisAcquireSpinLock の最適化されたバージョンです。

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

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

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

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

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisDprAcquireSpinLock (NDIS 5.1) を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisDprAcquireSpinLock (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)