Masterclock TCR1000 Bedienungsanleitung PDF herunterladen (Seite 10)

TCR1000SDK–Rev.3.0.0   Page10



TCR1000_ApiEnableCallback

TheTCR1000_ApiEnableCallbackfunctionenablestheasynchronouscallbackofauser‐supplied

callbackfunction,oraddshookstoanalready‐establishedcallbackfunction,onbehalfofthecalling

thread.



DWORDTCR1000_ApiEnableCallback(

DWORDcbToAdd,//maskofcallbackhooks

PTCRASYNC_CALLBACK_ROUTINEcbFunction//pointertouser‐suppliedcallbackfunction

);



Parameters

cbToAdd



AnycombinationofcallbackhooksASYNC_xxx(definedinINTAPI.H)tobeenabledoradded,from:



ASYNC_TIMESET Once/minuteinterrupt(second=30,frame=0)

ASYNC_PERSEC Once/secondinterrupt(second=0)

ASYNC_ENDTC Once/frameinterrupt(aftertimecodedata,beforesyncword)

ASYNC_STARTTC Once/frameinterrupt(beforetimecodedata,aftersyncword)

ASYNC_TIMELOSS Timecodelost

ASYNC_TIMEGAIN Timecoderegainedfromloststate



cbFunction



Auser‐suppliedcallbackfunctionoftypePTCRASYNC_CALLBACK_ROUTINE.Askeletonexampleof

thecallbackfunctionwouldbe:



DWORD_stdcallTCR1000_ApiAsyncCallback(DWORDdwStatus,PVOIDdata,DWORDdataLen)

{

//codeheretohandleasynchronousnotifications

}



ReturnValues

Onsuccess,thenewcallbackhooksmask(alwaysnon‐zero).Onfailure,0.



Remarks

Eachthreadinaprocessmayhaveanactivecallbackfunctionbutnomorethanone.Additionalcalls

toTCR1000_ApiEnableCallbackinthethreadwillusethefunctionpassedbytheinitialcall.Allcallsto

TCR1000_ApiEnableCallbackareonbehalfofthecallingthread,notthecallingprocess.

TCR1000_ApiEnableCallbackmust

becalledonceforeveryeventthatthecallbackfunctionshould

berunfor.Enablingacallback,insomecircumstances,can

affectthecallbackhooksofotherthreads

orotherprocessesusingtheAPI.SeethesectionentitledRelationshipofTCRInterruptstoAPI

AsynchronousNotificationsforadditionaldescriptionofissuesregardingtheuseofthisfunction.



1 2 ... 5 6 7 8 9 10 11 12 13 14 15 ... 22 23

Kommentare zu diesen Handbüchern

Keine Kommentare

Masterclock TCR1000 Bedienungsanleitung Seite 10

Kommentare zu diesen Handbüchern