queue_asynchronous_procedure_call

unsigned queue_asynchronous_procedure_call(asynchronous_procedure procedure,
                                           handle thread,
                                           void* data)

This function queues an asynchronous function to the thread.

Parameters

asynchronous_procedure procedure

A pointer to the function to be placed in the asynchronous queue for the thread.

handle thread

The handle of the thread to which the function is queued.

void* data

A value that is passed to the function as a parameter.

Return

unsigned

true	The function succeeded.
false	The call failed.

Notes

The calling application must have access thread_access::set_context.

The queued function is called when the thread enters an alertable wait state.

An alertable wait state may be entered by any of the functions:

• wait_for_single_object_extended,
• wait_for_multiple_objects_extended,
• message_wait_for_multiple_objects_extended,
• signal_object_and_wait or sleep_extended.