NdisMSynchronizeWithInterruptEx 関数 (ndis.h)

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

ミニポートドライバーは NdisMSynchronizeWithInterruptEx 関数を呼び出して、ミニポートドライバーが提供する関数の実行を MiniportInterrupt 関数と同期します。

構文

BOOLEAN NdisMSynchronizeWithInterruptEx(
  [in] NDIS_HANDLE                            NdisInterruptHandle,
  [in] ULONG                                  MessageId,
  [in] MINIPORT_SYNCHRONIZE_INTERRUPT_HANDLER SynchronizeFunction,
  [in] PVOID                                  SynchronizeFunction,
  [in] PVOID                                  SynchronizeContext
);

パラメーター

[in] NdisInterruptHandle

ミニポートドライバーがへの以前の呼び出しで取得した割り込みハンドル NdisMRegisterInterruptEx 関数。

[in] MessageId

ドライバーを同期する必要があるメッセージシグナル割り込み。 NDIS がドライバーのメッセージ通知割り込みを許可しなかった場合、NDIS はこのパラメーターを無視します。 MessageId は、のインデックスです。内の構造体をIO_INTERRUPT_MESSAGE_INFO_ENTRY する IO_INTERRUPT_MESSAGE_INFO 構造体。ドライバーが NdisMRegisterInterruptEx 関数を使用して MSI に正常に登録されると、NDIS は MessageInfoTable メンバーで関連付けられているIO_INTERRUPT_MESSAGE_INFO構造体へのポインターを渡します。

[in] SynchronizeFunction

ドライバーのエントリポイント MiniportSynchronizeInterrupt 関数。

[in] SynchronizeFunction

ドライバーのエントリポイント MiniportSynchronizeInterrupt 関数。

[in] SynchronizeContext

SynchronizeContext の MiniportSynchronizeInterrupt 関数に渡される、ミニポートドライバーによって決定されたコンテキスト領域へのポインター。

戻り値

NdisMSynchronizeWithInterruptEx は 、MiniportSynchronizeInterrupt が返すブール値を返します。

注釈

NdisMRegisterInterruptEx に割り込みを登録するミニポートドライバーは、NdisMSynchronizeWithInterruptEx を使用します。の値 MiniportSynchronizeInterrupt 関数の戻り値は、 NdisMSynchronizeWithInterruptEx によっても返されます。この伝達された値は、呼び出し元に状態を提供します。

DIRQL で実行される他のドライバー関数とリソースを共有するすべてのミニポートドライバー関数は、 NdisMSynchronizeWithInterruptEx を使用して、それらのリソースへのアクセスを同期する必要があります。 MiniportSynchronizeInterrupt 関数は DIRQL でも実行され、共有リソースはシステム割り当てスピンロックによって保護されます。したがって、共有リソースは 、MiniportInterrupt 関数と呼び出し元による同時アクセスから保護されます。

NdisMSynchronizeWithInterruptEx は 、システムスピンロックを解放し、コントロールを返す前に、呼び出し元の元の IRQL を復元します。

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

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h、Video.h を含む)
Library	Ndis.lib
IRQL	<= DIRQL
DDI コンプライアンス規則	NdisMDeregisterInterruptEx(ndis)