API Guide
2-356 API Functions 601355 Rev A
VS_Notify_
Listen VS_Notify_Listen listens for MediaClass callbacks from
Vol S e rv .
Client registers a notify dispatch routine with the API using
either the VS_Global_SetFields or the
VS_Notify_SetFields function. Client is then responsible
for putting the API into a “listening” state by calling
VS_Notify_Listen. VS_Notify_Listen terminates
either after receiving a MediaClass callback and notifying the
client’s notify dispatch routine or after timing out.
Synopsis int VS_Notify_Listen (VST_NOTIFY_HANDLE handle)
Arguments •handle = The notify handle used to listen for MediaClass
callbacks.
Return Values VS_Notify_Listen returns:
•VSE_ERR_BADHANDLE - Specified handle was not a
notify handle.
•VSE_ERR_NONE - Successfully received and processed a
callback.
•VSE_ERR_NOTINITIALIZED - The VolServ API is not
initialized.
•VSE_ERR_NULLHANDLE - Specified handle was a null
handle.
•VSE_ERR_SELECT - An error occurred during a select
system call.
•VSE_ERR_SIGNAL - A select system call was interrupted
by a signal.