NdisReEnumerateProtocolBindings 関数 (ndis.h)

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

NdisReEnumerateProtocolBindings 関数は、ドライバーがバインドするように構成されているが、ドライバーが現在バインドされていないミニポートアダプターごとに、プロトコルドライバーの ProtocolBindAdapterEx 関数を 1 回呼び出します。

構文

void NdisReEnumerateProtocolBindings(
  [in] NDIS_HANDLE NdisProtocolHandle
);

パラメーター

[in] NdisProtocolHandle

呼び出し元のプロトコルドライバーを表すハンドル。ドライバーは、への以前の呼び出しでこのハンドルを取得しました。 NdisRegisterProtocolDriver 関数。

戻り値

なし

解説

プロトコルドライバーは、 NdisReEnumerateProtocolBindings 関数を 呼び出して、1 つ以上のミニポートアダプターに再バインドできます。

プロトコルドライバーは、ProtocolBindAdapterEx のコンテキスト内から NdisReEnumerateProtocolBindings を呼び出すことはできません。 ProtocolUnbindAdapterEx 関数。また、プロトコルドライバーは、ProtocolNetPnPEvent 関数のコンテキスト内から NdisReEnumerateProtocolBindings を呼び出すことはできません。
ProtocolNetPnPEvent の ProtocolBindingContext パラメーターが NULL ではありません。ただし、ProtocolBindingContext が NULL の場合、プロトコルドライバーは ProtocolNetPnPEvent のコンテキスト内から NdisReEnumerateProtocolBindings を呼び出すことができます。 NULLProtocolBindingContext 値は、イベントがすべてのバインディングに適用されることを示します。

NDIS は、NdisReEnumerateProtocolBindings の呼び出しが返された後、バインド操作を完了する可能性があります。つまり、NDIS は、プロトコルドライバーがバインドするように構成されているが、プロトコルドライバーが後で現在バインドされていないミニポートアダプターへのバインドを完了する可能性があります。

中間ドライバーは、ProtocolNetPnPEvent 関数が NULLProtocolBindingContext で NetEventReconfigure を受け取った後、NdisReEnumerateProtocolBindings を呼び出す必要があります。その後、NDIS は、ドライバーがバインドするように構成されているが、ドライバーが現在バインドされていないミニポートアダプターごとに、ドライバーの ProtocolBindAdapterEx 関数を 1 回呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisReEnumerateProtocolBindings (NDIS 5.1)」を参照) でサポートされています。 Windows XP での NDIS 5.1 ドライバー (「NdisReEnumerateProtocolBindings (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_Miscellaneous_Function(ndis)、 NdisReEnumerateProtocolBindings(ndis)