Set_Conversation_Type呼叫 (函 式 名稱 cmsct) 是由叫用程式發出,以將交談定義為對應或基本。 此呼叫會覆寫 Initialize_Conversation所建立的默認交談類型。 默認交談類型為 CM_MAPPED_CONVERSATION。 發出 [配置 ] 之後,便無法發出此呼叫。
語法
CM_ENTRY Set_Conversation_Type(
unsigned char FAR *conversation_ID,
CM_INT32 FAR *conversation_type,
CM_INT32 FAR *return_code
);
參數
conversation_ID
提供的參數。 指定交談的標識碼。 此參數的值是由 Initialize_Conversation 所傳回。
conversation_type
提供的參數。 指定要由 Allocate 配置的交談類型。 可能的值為:
CM_BASIC_CONVERSATION
CM_MAPPED_CONVERSATION
return_code
從這個呼叫傳回的程序代碼。 本主題稍後會列出有效的傳回碼。
回傳代碼
CM_OK
主要傳回碼;已成功執行的呼叫。
CM_PROGRAM_STATE_CHECK
主要傳回碼;交談不是處於 INITIALIZE 狀態。
CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項:
conversation_ID或conversation_type指定的值無效。
conversation_type 參數會指定對應的交談,但填滿特性會設定為 CM_FILL_BUFFER,這與對應的交談不相容。 將交談類型變更為對應的之前,您必須發出 Set_Fill 呼叫,將填滿類型變更為CM_FILL_LL。
conversation_type參數會指定對應的交談。 不過,先前 的Set_Log_Data 呼叫只允許在基本交談中,仍然有效。
CM_PRODUCT_SPECIFIC_ERROR
主要傳回碼;發生產品特定的錯誤,且已在產品錯誤記錄檔中記錄。
狀態變更
交談必須處於 INITIALIZE 狀態。
沒有狀態變更。