NdisCmRegisterAddressFamilyEx 函式 (ndis.h)
NdisCmRegisterAddressFamilyEx 函式會註冊位址系列 (AF) ,以在 CoNDIS 驅動程式之間進行通訊。
語法
NDIS_STATUS NdisCmRegisterAddressFamilyEx(
[in] NDIS_HANDLE NdisBindingHandle,
[in] PCO_ADDRESS_FAMILY AddressFamily
);
參數
[in] NdisBindingHandle
NdisOpenAdapterEx 函式之 NdisBindingHandle 參數所提供的 NDIS 句柄。 這個句柄會識別要與 AF 相關聯的系結。
[in] AddressFamily
CO_ADDRESS_FAMILY 結構的指標,可識別呼叫管理員以及它針對 NdisBindingHandle 所指定的系結所支援的 AF。
AddressFamily 的指標會變成 的輸入參數系結至相同 CoNDIS 迷你埠配接器之所有用戶端的 ProtocolCoAfRegisterNotify 函式。
傳回值
NdisCmRegisterAddressFamilyEx 可以傳回下列任一項:
傳回碼 | Description |
---|---|
|
通訊協定驅動程式已註冊 AddressFamily 所指向的 AF,因此 NDIS 會呼叫所有系結至相同迷你埠適配卡之用戶端的 ProtocolCoAfRegisterNotify 函式。 |
|
要求的作業失敗,因為 NDIS 無法配置足夠的記憶體,或初始化它用來追蹤呼叫管理員或指定 AF 的狀態。 |
|
NDIS 呼叫 NdisCmRegisterAddressFamilyEx 失敗,可能是下列其中一個原因:
|
備註
NDIS 獨立呼叫管理員,可藉由呼叫 註冊為 NDIS 通訊協定驅動程式 NdisRegisterProtocolDriver 函 式應該呼叫 NdisCmRegisterAddressFamilyEx 函 式來註冊 AF。 (MC) 的迷你埠通話管理員必須改為呼叫 NdisMCmRegisterAddressFamilyEx 函 式。
若要註冊系結的 AF,獨立呼叫管理員應該從呼叫 NdisCmRegisterAddressFamilyEx ProtocolBindAdapterEx 函 式。
獨立呼叫管理員的 ProtocolBindAdapterEx 函式會先呼叫 NdisOpenAdapterEx 函式來建立基礎迷你埠驅動程式的系結。 每次 NDIS 使用 BindContext 參數的另一個句柄呼叫 ProtocolBindAdapterEx 時,ProtocolBindAdapterEx 都會建立系結,並註冊其支援的 AF。 換句話說,獨立呼叫管理員最終會針對每個系結註冊 AF,其會為其為連線導向用戶端提供呼叫管理服務。
呼叫管理員可以支援多個 AF,並可支援單一系結的多個 AF。 不過,只有一個呼叫管理員可以針對系結至指定迷你埠配接器的客戶端支援指定的 AF。
當呼叫管理員的 ProtocolBindAdapterEx 函式在成功系結作業之後傳回控制權時,NDIS 會呼叫系結至相同迷你埠配接器之所有用戶端的 ProtocolCoAfRegisterNotify 函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平台 | 桌面 |
標頭 | ndis.h (包含 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | Irql_CallManager_Function () |