NdisReEnumerateProtocolBindings 関数 (ndis.h)
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) |