NdisDprAcquireSpinLock マクロ (ndis.h)

[アーティクル]
02/07/2025

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 マイクロ秒より長く保持すると、システムとドライバーの両方のパフォーマンスが低下します。

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

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisDprAcquireSpinLock (NDIS 5.1) を参照) でサポートされています。 Windows XP で NDIS 5.1 ドライバー (NdisDprAcquireSpinLock (NDIS 5.1) を参照) でサポートされています。
ターゲットプラットフォームの	万国
ヘッダー	ndis.h (Ndis.h を含む)
ライブラリ	Ndis.lib
IRQL	DISPATCH_LEVEL
DDI コンプライアンス規則をする	Irql_Synch_Function(ndis), SpinLock(ndis), SpinLockBalanced(ndis), SpinLockDpr(ndis), SpinLockDprRelease(ndis), SpinlockRelease(ndis)

次の方法で共有

NdisDprAcquireSpinLock マクロ (ndis.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース