Request_To_Send (CPI-C)

  • 發行項

Request_To_Send呼叫 (函式名稱cmrts) 通知合作夥伴計畫本機計畫想要傳送資料。

語法

  
CM_ENTRY Request_To_Send(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *return_code              
);

參數

conversation_ID
提供的 參數。 指定交談的識別碼。 此參數的值是由 Initialize_Conversation 或 Accept_Conversation傳回。

return_code
從這個呼叫傳回的程式碼。 本主題稍後會列出有效的傳回碼。

傳回碼

CM_OK
主要傳回碼;已成功執行呼叫。

CM_OPERATION_NOT_ACCEPTED
主要傳回碼;此交談的上一個作業不完整。

CM_OPERATION_INCOMPLETE
主要傳回碼;作業尚未完成 (處理模式只會) 封鎖且仍在進行中。 程式可以發出 Wait_For_Conversation 以等候作業完成，或 Cancel_Conversation 取消作業和交談。 如果已呼叫 Specify_Windows_Handle ，應用程式應該等候 Microsoft® Windows® 訊息通知，而不是呼叫 Wait_For_Conversation。

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼; conversation_ID 指定的值無效。

CM_PROGRAM_STATE_CHECK
主要傳回碼;交談不在 RECEIVE、SEND、SEND_PENDING、CONFIRM、CONFIRM_SEND或CONFIRM_DEALLOCATE狀態。

CM_PRODUCT_SPECIFIC_ERROR
主要傳回碼;發生產品特定的錯誤，且已在產品錯誤記錄檔中記錄。

狀態變更

交談可以是下列任何狀態：RECEIVE、SEND、SEND_PENDING、CONFIRM、CONFIRM_SEND或CONFIRM_DEALLOCATE。

沒有狀態變更。

為了回應此要求，合作夥伴計畫可以發出下列其中一個呼叫，將交談變更為 RECEIVE 狀態：

  • 接收的接收 類型設定為 CM_RECEIVE_AND_WAIT

  • Prepare_To_Receive

  • Send_Data 將傳送類型設定為 CM_SEND_AND_PREP_TO_RECEIVE

    合作夥伴計畫也可以忽略傳送的要求。

    當本機程式透過後續Receive呼叫的status_received參數收到下列其中一個值時，交談狀態會變更為 LOCAL 程式的 SEND：

  • CM_SEND_RECEIVED

  • CM_CONFIRM_SEND_RECEIVED，且本機程式會以 確認 的通話回復

備註

合作夥伴計畫會透過下列呼叫的 request_to_send_received 參數收到要求到傳送通知：

  • 已確認

  • 接收

  • Send_Data

  • Send_Error

  • Test_Request_To_Send_Received

    要求傳送通知會立即傳送給合作夥伴計畫。 CPI-C 不會等到傳送緩衝區填滿或排清為止。 因此，要求到傳送通知可能會依序送達。 例如，如果本機程式處於 SEND 狀態，併發出 Prepare_To_Receive 呼叫，後面接著 Request_To_Send 呼叫，則合作夥伴計畫處於 RECEIVE 狀態，可以在接收傳送通知之前接收要求到傳送通知。 基於這個理由， request_to_send 可以透過 接收 呼叫向程式回報。

    收到要求傳送通知時，合作夥伴邏輯單元 (LU) 會保留通知，直到合作夥伴發出傳回 request_to_send_received的呼叫為止。 LU 只會針對每個交談保留一個要求傳送通知。 因此，本機程式可能會 發出比合作夥伴 交易計畫明確處理的Request_To_Send呼叫 (TP) 。