RegisterMailboxCallback

註冊一個函式，當信箱消息進入時，KINGSTAR 子系統將呼叫該函數。

語法

KsError RegisterMailboxCallback(
     MailboxCallback callback,
     PVOID context
);

參數

callback：信箱訊息進來時將呼叫的函式指標。請見 MailboxCallback 類型。

context：若需要，傳遞給回呼函式的指標。

回傳值

如果此函式執行成功，會回傳 errNoError，否則會傳回錯誤碼。如需更多有關錯誤碼的資訊，請參閱 KsError 清單。

可用的 EtherCAT 狀態

ecatInit, ecatBoot, ecatPreOP, ecatSafeOP, ecatOP

範例

複製

/*
*    Assume that there is already a callback function in namespace userApp:
*    namespace userApp
*    {
*        static UCHAR VoEData[2048] = { 0 };
*
*        int mbCallBack(PVOID Context, INT SlaveId, MailboxType Type, MailboxData Data)
*        {
*            if (Type == MailboxType::mbVoe)
*                memcpy((void*)VoEData, (void*)Data.Voe.Data, Data.Voe.DataLength);
*
*            return 0;
*        }
*    }
*/
MailboxCallback callBack = userApp::mbCallBack;
nRet = RegisterMailboxCallback(callBack, NULL);

使用需求

	RT	Win32
最低支援版本	4.2	4.2
標頭檔	ksapi.h	ksapi.h
程式庫	KsApi_Rtss.lib	KsApi.lib

參見

Create

RegisterCallback

Start