NdisReEnumerateProtocolBindings 函式 (ndis.h)

NdisReEnumerateProtocolBindings 函式會讓 NDIS 呼叫通訊協定驅動程式的 ProtocolBindAdapterEx 函式一次,供驅動程式設定為系結的每個迷你埠適配卡一次,但驅動程式目前未系結至該適配卡。

語法

void NdisReEnumerateProtocolBindings(
  [in] NDIS_HANDLE NdisProtocolHandle
);

參數

[in] NdisProtocolHandle

表示呼叫通訊協定驅動程式的句柄。 驅動程式已透過先前呼叫 取得此句柄 NdisRegisterProtocolDriver 函式。

傳回值

備註

通訊協議驅動程式可以呼叫 NdisReEnumerateProtocolBindings 函式,以重新系結至一或多個迷你埠配接器。

通訊協議驅動程式無法從 ProtocolBindAdapterEx 的內容中呼叫 NdisReEnumerateProtocolBindings,或 ProtocolUnbindAdapterEx 函式。 此外,如果 ,通訊協定驅動程式無法在 ProtocolNetPnPEvent 函式的內容中呼叫 NdisReEnumerateProtocolBindings
ProtocolNetPnPEventProtocolBindingContext 參數不是 NULL。 不過,如果 ProtocolBindingContextNULL,通訊協定驅動程式可以從 ProtocolNetPnPEvent 的內容中呼叫 NdisReEnumerateProtocolBindingSNULLProtocolBindingContext 值表示事件會套用至所有系結。

NDIS 可能會在呼叫 NdisReEnumerateProtocolBindings 傳回之後完成系結作業。 也就是說,NDIS 可能會完成通訊協定驅動程式設定為系結的迷你埠適配卡系結,但通訊協定驅動程式目前未在稍後系結至該配接器。

中繼驅動程式應該在其 ProtocolNetPnPEvent 函式收到 NULLProtocolBindingContext 上的 NetEventReconfigure 之後呼叫 NdisReumerateProtocolBindings 。 接著,NDIS 會針對驅動程式設定為系結的每個迷你埠適配卡呼叫驅動程式的 ProtocolBindAdapterEx 函式一次,但驅動程式目前未系結至該適配卡。

規格需求

需求
最低支援的用戶端 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisReEnumerateProtocolBindings (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisReEnumerateProtocolBindings (NDIS 5.1) ) 。
目標平台 桌面
標頭 ndis.h (包括 Ndis.h)
程式庫 Ndis.lib
IRQL PASSIVE_LEVEL
DDI 合規性規則 Irql_Miscellaneous_Function (ndis) NdisReEnumerateProtocolBindings (ndis)

另請參閱

MiniportInitializeEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

ProtocolNetPnPEvent

ProtocolUnbindAdapterEx