PROTOCOL_CM_INCOMING_CALL_COMPLETE回呼函式 (ndis.h)
需要 ProtocolCmIncomingCallComplete 函式。 當 NDIS 呼叫此函式時,ProtocolCmIncomingCallComplete 向呼叫管理員指出連線導向用戶端已完成呼叫供應項目的處理,而呼叫管理員先前已透過該呼叫管理員分派 NdisCmDispatchIncomingCall。
語法
PROTOCOL_CM_INCOMING_CALL_COMPLETE ProtocolCmIncomingCallComplete;
void ProtocolCmIncomingCallComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE CallMgrVcContext,
[in] PCO_CALL_PARAMETERS CallParameters
)
{...}
參數
[in] Status
指出將連入呼叫分派給連線導向用戶端之作業的最終狀態。
[in] CallMgrVcContext
指定呼叫管理員配置的內容區域的句柄,其中呼叫管理員會維護其每個 VC 狀態。 呼叫管理員會從其 ProtocolCoCreateVc 函式中提供此句柄。
[in] CallParameters
呼叫中呼叫管理員所指定的呼叫參數指標,NdisCmDispatchIncomingCall。 訊號通訊協議會決定呼叫管理員可以變更的呼叫參數。
傳回值
沒有
言論
當連線導向用戶端已完成呼叫管理員分派給它的連入連線供應項目處理時,如果傳回NDIS_STATUS_PENDING NdisCmDispatchIncomingCall,就會呼叫此例程。 在 [狀態] 中找到來電的最終狀態。 Status 的可能值包括,但不限於:
如果用戶端接受來電,呼叫管理員應該傳送訊號訊息,以向呼叫實體指出已接受呼叫。 如果用戶端不接受呼叫,呼叫管理員應該傳送訊號訊息,以指出已拒絕呼叫。
範例
若要定義 ProtocolCmIncomingCallComplete 函式,您必須先提供函式宣告,以識別您要定義的函式類型。 Windows 提供一組驅動程式的函式類型。 使用函式類型宣告函式有助於 驅動程式的程式代碼分析、靜態驅動程序驗證器 (SDV)和其他驗證工具尋找錯誤,而且是撰寫 Windows作系統驅動程式的需求。例如,若要定義名為 「MyCmIncomingCallComplete」 的 ProtocolCmIncomingCallComplete 函式,請使用 PROTOCOL_CM_INCOMING_CALL_COMPLETE 類型,如下列程式代碼範例所示:
PROTOCOL_CM_INCOMING_CALL_COMPLETE MyCmIncomingCallComplete;
然後,實作您的函式,如下所示:
_Use_decl_annotations_
VOID
MyCmIncomingCallComplete(
NDIS_STATUS Status,
NDIS_HANDLE CallMgrVcContext,
PCO_CALL_PARAMETERS CallParameters
)
{...}
PROTOCOL_CM_INCOMING_CALL_COMPLETE 函式類型定義於 Ndis.h 頭檔中。 若要在執行程式代碼分析工具時更準確地識別錯誤,請務必將 Use_decl_annotations 批註新增至函式定義。 Use_decl_annotations 批注可確保會使用套用至頭檔中 PROTOCOL_CM_INCOMING_CALL_COMPLETE 函式類型的批注。 如需函式宣告需求的詳細資訊,請參閱 使用 NDIS 驅動程式的函式角色類型來宣告函式。
如需 Use_decl_annotations的相關信息,請參閱 批注函式行為。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 ProtocolCmIncomingCallComplete (NDIS 5.1) 。 支援 NDIS 5.1 驅動程式(請參閱 Windows XP 中的 ProtocolCmIncomingCallComplete (NDIS 5.1)。 |
目標平臺 | 窗戶 |
標頭 | ndis.h (包括 Ndis.h) |
IRQL | <= DISPATCH_LEVEL |