PROTOCOL_CM_MAKE_CALL回呼函式 （ndis.h）
ProtocolCmMakeCall 函式是必要函式，可設定虛擬連線的媒體特定參數，並啟動虛擬連線。
語法
PROTOCOL_CM_MAKE_CALL ProtocolCmMakeCall;
NDIS_STATUS ProtocolCmMakeCall(
[in] NDIS_HANDLE CallMgrVcContext,
[in, out] PCO_CALL_PARAMETERS CallParameters,
[in, optional] NDIS_HANDLE NdisPartyHandle,
[out, optional] PNDIS_HANDLE CallMgrPartyContext
)
{...}
參數
[in] CallMgrVcContext
指定呼叫管理員配置的內容區域的句柄，其中呼叫管理員會維護其每個 VC 狀態。 呼叫管理員會從其 ProtocolCoCreateVc 函式，將此句柄提供給 NDIS。
[in, out] CallParameters
CO_CALL_PARAMETERS 結構的指標，其中包含這個傳出呼叫的連接導向用戶端所指定的參數。
[in, optional] NdisPartyHandle
指定 NDIS 所提供的句柄，可唯一識別多點虛擬連線上的初始合作物件。 此句柄對呼叫管理員而言不透明，並保留給 NDIS 連結庫使用。 如果客戶端未設定傳出多點呼叫，此句柄 NULL。
[out, optional] CallMgrPartyContext
在傳回時，指定呼叫管理員提供之內容區域的句柄，其中呼叫管理員會在多點呼叫上維護初始方的狀態。 如果 NdisPartyHandleNULL，此句柄必須設定為 NULL。
傳回值
ProtocolCmMakeCall 會以下列其中一個值傳回其作業的狀態：
| 傳回碼 | 描述 |
|---|---|
|
表示呼叫管理員已成功配置必要的資源來進行呼叫，而且能夠啟用與迷你埠驅動程式的虛擬連線。 |
|
表示呼叫管理員會完成要求，以異步方式進行呼叫。 當呼叫管理員完成呼叫的所有作業時，它必須呼叫 NdisCmMakeCallComplete，以向 NDIS 發出已完成此呼叫的訊號。 |
|
表示呼叫管理員無法配置和/或初始化其資源，以啟用用戶端所要求的虛擬連線。 |
|
表示呼叫管理員無法啟動虛擬連線，因為呼叫端要求呼叫者在呼叫參數中要求無效或無法使用的功能，CallParameters 。 |
言論
如果指定 ProtocolCmMakeCall 明確 NdisPartyHandle，則用戶端已針對多點呼叫建立此 VC。 呼叫管理員必須配置和初始化維護狀態資訊及控制多點呼叫所需的任何必要資源。 這類資源包括但不限於記憶體緩衝區、數據結構、事件和其他類似的資源。 如果呼叫管理員無法為其狀態區域配置或初始化所需的資源，則應該使用 NDIS_STATUS_RESOURCES 將控制權傳回 NDIS。
ProtocolCmMakeCall 視需要與網路控制裝置或其他媒體特定動作項目通訊，以便根據在 callParameters 中指定的呼叫參數，在本機節點與遠端節點之間建立連線。 這類動作可能包括，但不限於與交換硬體的通訊、與網路控制站的通訊，或網路媒體適用的其他動作。
如果需要呼叫管理員才能與網路硬體通訊（例如網路交換器），它應該使用其 ProtocolBindAdapterEx 函式中建立的網路控制裝置的虛擬連線。 呼叫管理員透過迷你埠驅動程式與其網路硬體通訊，方法是呼叫 NdisCoSendNetBufferLists。 具有整合式呼叫管理支援的迷你埠驅動程式不會呼叫 NdisCoSendNetBufferLists，而是會自行傳輸數據。
在通話管理員依照媒體要求，與網路硬體進行所有必要的通訊之後，通話管理員必須呼叫 NdisCmActivateVc。
如果此呼叫是多點呼叫，在呼叫管理員與網路硬體通訊、已驗證的呼叫參數，以及配置並初始化其每一方狀態數據之後，其狀態區塊的位址應該在呼叫 CallMgrPartyContext 句柄中設定，再將控制權傳回 NDIS。 句柄的設定方式是取值句柄，並將狀態區塊的指標儲存為句柄的值。 例如：
*CallMgrPartyContext = SomeBuffer ;
如果 ProtocolCmMakeCall 已完成其網路所需的作業，且 VC 已透過 NdisCmActivateVc成功啟用，ProtocolCmMakeCall 應儘快傳回控制權，且狀態為 STATUS_SUCCESS。
ProtocolCmMakeCall 將控制權傳回 NDIS 之後，呼叫管理員應該不會對此呼叫採取任何進一步的動作來設定它。 ProtocolCmMakeCall 負責建立連線，讓用戶端可以透過此 VC 上的網路進行數據傳輸。 不過，接著可以呼叫呼叫管理員來修改呼叫的服務品質，如果這是多點 VC，則新增或卸除合作對象，最後終止此呼叫。
範例
若要定義 ProtocolCmMakeCall 函式，您必須先提供函式宣告，以識別您要定義的函式類型。 Windows 提供一組驅動程式的函式類型。 使用函式類型宣告函式有助於 驅動程式的程式代碼分析、靜態驅動程序驗證器 （SDV）和其他驗證工具尋找錯誤，而且是撰寫 Windows作系統驅動程式的需求。例如，若要定義名為 「MyCmMakeCall」 的 ProtocolCmMakeCall 函式，請使用 PROTOCOL_CM_MAKE_CALL 類型，如下列程式代碼範例所示：
PROTOCOL_CM_MAKE_CALL MyCmMakeCall;
然後，實作您的函式，如下所示：
_Use_decl_annotations_
NDIS_STATUS
MyCmMakeCall(
NDIS_HANDLE CallMgrVcContext,
PCO_CALL_PARAMETERS CallParameters,
NDIS_HANDLE NdisPartyHandle,
PNDIS_HANDLE CallMgrPartyContext
)
{...}
PROTOCOL_CM_MAKE_CALL 函式類型定義於 Ndis.h 頭檔中。 若要在執行程式代碼分析工具時更準確地識別錯誤，請務必將 Use_decl_annotations 批註新增至函式定義。 Use_decl_annotations 批注可確保在頭檔中套用至 PROTOCOL_CM_MAKE_CALL 函式類型的批注。 如需函式宣告需求的詳細資訊，請參閱 使用 NDIS 驅動程式的函式角色類型來宣告函式。
如需 Use_decl_annotations的相關信息，請參閱 批注函式行為。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式（請參閱 ProtocolCmMakeCall （NDIS 5.1） 。 支援 NDIS 5.1 驅動程式（請參閱 Windows XP 中的 ProtocolCmMakeCall （NDIS 5.1）。 |
| 目標平臺 | 窗戶 |
| 標頭 | ndis.h （包括 Ndis.h） |
| IRQL | <= DISPATCH_LEVEL |