NdisClOpenAddressFamilyEx 函式 (ndis.h)

發行項
02/29/2024

NdisClOpenAddressFamilyEx 函式會註冊與連接導向用戶端之呼叫管理員相關聯的位址系列 (AF) 。

語法

NDIS_STATUS NdisClOpenAddressFamilyEx(
  [in]  NDIS_HANDLE        NdisBindingHandle,
  [in]  PCO_ADDRESS_FAMILY AddressFamily,
  [in]  NDIS_HANDLE        ClientAfContext,
  [out] PNDIS_HANDLE       NdisAfHandle
);

參數

[in] NdisBindingHandle

NdisOpenAdapterEx 傳回的句柄，識別目標網路介面卡 (NIC) 或呼叫端所系結下一個較低驅動程式的虛擬適配卡。

[in] AddressFamily

描述要開啟之呼叫管理員和 AF 之CO_ADDRESS_FAMILY 結構的指標。

此指標是客戶端的輸入參數 ProtocolCoAfRegisterNotify 函式，其會呼叫 NdisClOpenAddressFamilyEx。

[in] ClientAfContext

呼叫端提供的駐留內容區域的句柄，用戶端會在開啟 AF 之後維護此 AF 的狀態。如果 呼叫 NdisClOpenAddressFamilyEx 成功，NDIS 會在與這個 AF 相關的所有後續呼叫中，將此句柄傳回用戶端。

[out] NdisAfHandle

NdisClOpenAddressFamilyEx 傳回代表新開啟之位址系列之呼叫端變數的指標。

傳回值

當 NdisClOpenAddressFamilyEx 傳回NDIS_STATUS_PENDING以外的任何專案時，客戶端應該對其進行內部呼叫 ProtocolClOpenAfCompleteEx 函式。否則，NDIS 會在完成此作業時呼叫用戶端的 ProtocolClOpenAfCompleteEx 函式。

備註

CoNDIS 用戶端會從其呼叫 NdisClOpenAddressFamilyEx ProtocolCoAfRegisterNotify 函式，在客戶端檢查 AddressFamily 參數所指向的輸入緩衝區，以判斷用戶端是否辨識呼叫管理員和已註冊的位址。 NDIS 會將 用戶端的 NdisClOpenAddressFamilyEx 呼叫轉送到呼叫管理員的 ProtocolCmOpenAf 函式，以確保用戶端已傳入有效的 AF 結構。

成功呼叫 NdisClOpenAddressFamilyEx 會設定從用戶端到呼叫管理員的通訊。然後，用戶端就可以呼叫 NdisClRegisterSap 函式來準備接收傳入呼叫。用戶端也可以藉由呼叫 NdisCoCreateVc 函式來設定虛擬連線 (VC) ，以便呼叫 NdisClMakeCall 函式來進行傳出呼叫。

如果用戶端對 NdisClOpenAddressFamilyEx 的呼叫失敗，客戶端應該呼叫 NdisUnbindAdapter 函式，要求 NDIS 將其系結釋放至基礎迷你埠配接器。否則，客戶端必須儲存 在 NdisAfHandle 參數傳回的句柄。此句柄會識別後續關於指定位址系列的要求導向的呼叫管理員。客戶端必須將這個傳回的句柄視為不透明變數，並在後續 的 NdisXxx 函式呼叫中傳遞未修改且未解譯的句柄。

NDIS 會將來自 ClientAfContext 參數的指標傳遞至用戶端在與 AF 相關的所有後續呼叫中註冊的 ProtocolClXxx 函式，直到用戶端使用相同的 NdisAfHandle 呼叫 NdisCloseAddressFamily 為止。關閉 AF 之後，用戶端就可以釋放或重複使用其配置於 ClientAfContext 的記憶體。

規格需求

需求	值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平台	桌面
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 合規性規則	Irql_Protocol_Driver_Function (ndis)