2 * Message queues related functions
4 * Copyright 1993, 1994 Alexandre Julliard
13 #include "wine/winbase16.h"
14 #include "wine/winuser16.h"
20 #include "debugtools.h"
24 DEFAULT_DEBUG_CHANNEL(msg);
27 static HQUEUE16 hExitingQueue = 0;
28 static PERQUEUEDATA *pQDataWin16 = NULL; /* Global perQData for Win16 tasks */
30 HQUEUE16 hActiveQueue = 0;
33 /***********************************************************************
36 * Increment reference count for the PERQUEUEDATA instance
37 * Returns reference count for debugging purposes
39 static void PERQDATA_Addref( PERQUEUEDATA *pQData )
42 TRACE_(msg)("(): current refcount %lu ...\n", pQData->ulRefCount);
44 InterlockedIncrement( &pQData->ulRefCount );
48 /***********************************************************************
51 * Release a reference to a PERQUEUEDATA instance.
52 * Destroy the instance if no more references exist
53 * Returns reference count for debugging purposes
55 static void PERQDATA_Release( PERQUEUEDATA *pQData )
58 TRACE_(msg)("(): current refcount %lu ...\n",
59 (LONG)pQData->ulRefCount );
61 if (!InterlockedDecrement( &pQData->ulRefCount ))
63 DeleteCriticalSection( &pQData->cSection );
65 TRACE_(msg)("(): deleting PERQUEUEDATA instance ...\n" );
67 /* Deleting our global 16 bit perQData? */
68 if ( pQData == pQDataWin16 ) pQDataWin16 = 0;
70 /* Free the PERQUEUEDATA instance */
71 HeapFree( GetProcessHeap(), 0, pQData );
76 /***********************************************************************
77 * PERQDATA_CreateInstance
79 * Creates an instance of a reference counted PERQUEUEDATA element
80 * for the message queue. perQData is stored globally for 16 bit tasks.
82 * Note: We don't implement perQdata exactly the same way Windows does.
83 * Each perQData element is reference counted since it may be potentially
84 * shared by multiple message Queues (via AttachThreadInput).
85 * We only store the current values for Active, Capture and focus windows
88 static PERQUEUEDATA * PERQDATA_CreateInstance(void)
96 /* Share a single instance of perQData for all 16 bit tasks */
97 if ( ( bIsWin16 = !(NtCurrentTeb()->tibflags & TEBF_WIN32) ) )
99 /* If previously allocated, just bump up ref count */
102 PERQDATA_Addref( pQDataWin16 );
107 /* Allocate PERQUEUEDATA from the system heap */
108 if (!( pQData = (PERQUEUEDATA *) HeapAlloc( GetProcessHeap(), 0,
109 sizeof(PERQUEUEDATA) ) ))
113 pQData->hWndCapture = pQData->hWndFocus = pQData->hWndActive = 0;
114 pQData->ulRefCount = 1;
115 pQData->nCaptureHT = HTCLIENT;
117 /* Note: We have an independent critical section for the per queue data
118 * since this may be shared by different threads. see AttachThreadInput()
120 InitializeCriticalSection( &pQData->cSection );
121 /* FIXME: not all per queue data critical sections should be global */
122 MakeCriticalSectionGlobal( &pQData->cSection );
124 /* Save perQData globally for 16 bit tasks */
126 pQDataWin16 = pQData;
132 /***********************************************************************
133 * PERQDATA_GetFocusWnd
135 * Get the focus hwnd member in a threadsafe manner
137 HWND PERQDATA_GetFocusWnd( PERQUEUEDATA *pQData )
140 assert(pQData != 0 );
142 EnterCriticalSection( &pQData->cSection );
143 hWndFocus = pQData->hWndFocus;
144 LeaveCriticalSection( &pQData->cSection );
150 /***********************************************************************
151 * PERQDATA_SetFocusWnd
153 * Set the focus hwnd member in a threadsafe manner
155 HWND PERQDATA_SetFocusWnd( PERQUEUEDATA *pQData, HWND hWndFocus )
158 assert(pQData != 0 );
160 EnterCriticalSection( &pQData->cSection );
161 hWndFocusPrv = pQData->hWndFocus;
162 pQData->hWndFocus = hWndFocus;
163 LeaveCriticalSection( &pQData->cSection );
169 /***********************************************************************
170 * PERQDATA_GetActiveWnd
172 * Get the active hwnd member in a threadsafe manner
174 HWND PERQDATA_GetActiveWnd( PERQUEUEDATA *pQData )
177 assert(pQData != 0 );
179 EnterCriticalSection( &pQData->cSection );
180 hWndActive = pQData->hWndActive;
181 LeaveCriticalSection( &pQData->cSection );
187 /***********************************************************************
188 * PERQDATA_SetActiveWnd
190 * Set the active focus hwnd member in a threadsafe manner
192 HWND PERQDATA_SetActiveWnd( PERQUEUEDATA *pQData, HWND hWndActive )
195 assert(pQData != 0 );
197 EnterCriticalSection( &pQData->cSection );
198 hWndActivePrv = pQData->hWndActive;
199 pQData->hWndActive = hWndActive;
200 LeaveCriticalSection( &pQData->cSection );
202 return hWndActivePrv;
206 /***********************************************************************
207 * PERQDATA_GetCaptureWnd
209 * Get the capture hwnd member in a threadsafe manner
211 HWND PERQDATA_GetCaptureWnd( INT *hittest )
214 PERQUEUEDATA *pQData;
217 if (!(queue = QUEUE_Lock( GetFastQueue16() ))) return 0;
218 pQData = queue->pQData;
220 EnterCriticalSection( &pQData->cSection );
221 hWndCapture = pQData->hWndCapture;
222 *hittest = pQData->nCaptureHT;
223 LeaveCriticalSection( &pQData->cSection );
225 QUEUE_Unlock( queue );
230 /***********************************************************************
231 * PERQDATA_SetCaptureWnd
233 * Set the capture hwnd member in a threadsafe manner
235 HWND PERQDATA_SetCaptureWnd( HWND hWndCapture, INT hittest )
238 PERQUEUEDATA *pQData;
241 if (!(queue = QUEUE_Lock( GetFastQueue16() ))) return 0;
242 pQData = queue->pQData;
244 EnterCriticalSection( &pQData->cSection );
245 hWndCapturePrv = pQData->hWndCapture;
246 pQData->hWndCapture = hWndCapture;
247 pQData->nCaptureHT = hittest;
248 LeaveCriticalSection( &pQData->cSection );
250 QUEUE_Unlock( queue );
251 return hWndCapturePrv;
256 /***********************************************************************
259 * Function for getting a 32 bit pointer on queue structure. For thread
260 * safeness programmers should use this function instead of GlobalLock to
261 * retrieve a pointer on the structure. QUEUE_Unlock should also be called
262 * when access to the queue structure is not required anymore.
264 MESSAGEQUEUE *QUEUE_Lock( HQUEUE16 hQueue )
268 HeapLock( GetProcessHeap() ); /* FIXME: a bit overkill */
269 queue = GlobalLock16( hQueue );
270 if ( !queue || (queue->magic != QUEUE_MAGIC) )
272 HeapUnlock( GetProcessHeap() );
277 HeapUnlock( GetProcessHeap() );
282 /***********************************************************************
285 * Use with QUEUE_Lock to get a thread safe access to message queue
288 void QUEUE_Unlock( MESSAGEQUEUE *queue )
292 HeapLock( GetProcessHeap() ); /* FIXME: a bit overkill */
294 if ( --queue->lockCount == 0 )
296 if (queue->server_queue)
297 CloseHandle( queue->server_queue );
298 GlobalFree16( queue->self );
301 HeapUnlock( GetProcessHeap() );
306 /***********************************************************************
307 * QUEUE_IsExitingQueue
309 BOOL QUEUE_IsExitingQueue( HQUEUE16 hQueue )
311 return (hExitingQueue && (hQueue == hExitingQueue));
315 /***********************************************************************
316 * QUEUE_SetExitingQueue
318 void QUEUE_SetExitingQueue( HQUEUE16 hQueue )
320 hExitingQueue = hQueue;
324 /***********************************************************************
325 * QUEUE_CreateMsgQueue
327 * Creates a message queue. Doesn't link it into queue list!
329 static HQUEUE16 QUEUE_CreateMsgQueue( BOOL16 bCreatePerQData )
333 MESSAGEQUEUE * msgQueue;
335 TRACE_(msg)("(): Creating message queue...\n");
337 if (!(hQueue = GlobalAlloc16( GMEM_FIXED | GMEM_ZEROINIT,
338 sizeof(MESSAGEQUEUE) )))
341 msgQueue = (MESSAGEQUEUE *) GlobalLock16( hQueue );
347 SERVER_START_REQ( get_msg_queue )
350 handle = req->handle;
355 ERR_(msg)("Cannot get thread queue");
356 GlobalFree16( hQueue );
359 msgQueue->server_queue = handle;
362 msgQueue->self = hQueue;
363 msgQueue->lockCount = 1;
364 msgQueue->magic = QUEUE_MAGIC;
366 /* Create and initialize our per queue data */
367 msgQueue->pQData = bCreatePerQData ? PERQDATA_CreateInstance() : NULL;
373 /***********************************************************************
374 * QUEUE_DeleteMsgQueue
376 * Unlinks and deletes a message queue.
378 * Note: We need to mask asynchronous events to make sure PostMessage works
379 * even in the signal handler.
381 BOOL QUEUE_DeleteMsgQueue( HQUEUE16 hQueue )
383 MESSAGEQUEUE * msgQueue = QUEUE_Lock(hQueue);
385 TRACE_(msg)("(): Deleting message queue %04x\n", hQueue);
387 if (!hQueue || !msgQueue)
389 ERR_(msg)("invalid argument.\n");
395 if( hActiveQueue == hQueue ) hActiveQueue = 0;
396 if (hExitingQueue == hQueue) hExitingQueue = 0;
398 HeapLock( GetProcessHeap() ); /* FIXME: a bit overkill */
400 /* Release per queue data if present */
401 if ( msgQueue->pQData )
403 PERQDATA_Release( msgQueue->pQData );
404 msgQueue->pQData = 0;
409 HeapUnlock( GetProcessHeap() );
411 /* free up resource used by MESSAGEQUEUE structure */
412 msgQueue->lockCount--;
413 QUEUE_Unlock( msgQueue );
419 /***********************************************************************
420 * handle_sent_message
422 * Handle the reception of a sent message by calling the corresponding window proc
424 static void handle_sent_message( QMSG *msg )
427 MESSAGEQUEUE *queue = QUEUE_Lock( GetFastQueue16() );
428 DWORD extraInfo = queue->GetMessageExtraInfoVal; /* save ExtraInfo */
429 WND *wndPtr = WIN_FindWndPtr( msg->msg.hwnd );
431 TRACE( "got hwnd %x msg %x (%s) wp %x lp %lx\n",
432 msg->msg.hwnd, msg->msg.message, SPY_GetMsgName(msg->msg.message),
433 msg->msg.wParam, msg->msg.lParam );
435 queue->GetMessageExtraInfoVal = msg->extraInfo;
437 /* call the right version of CallWindowProcXX */
441 result = CallWindowProc16( (WNDPROC16)wndPtr->winproc,
442 (HWND16) msg->msg.hwnd,
443 (UINT16) msg->msg.message,
444 LOWORD(msg->msg.wParam),
448 result = CallWindowProcA( wndPtr->winproc, msg->msg.hwnd, msg->msg.message,
449 msg->msg.wParam, msg->msg.lParam );
452 result = CallWindowProcW( wndPtr->winproc, msg->msg.hwnd, msg->msg.message,
453 msg->msg.wParam, msg->msg.lParam );
457 queue->GetMessageExtraInfoVal = extraInfo; /* Restore extra info */
458 WIN_ReleaseWndPtr(wndPtr);
459 QUEUE_Unlock( queue );
461 SERVER_START_REQ( reply_message )
463 req->result = result;
471 /***********************************************************************
472 * process_sent_messages
474 * Process all pending sent messages
476 static void process_sent_messages(void)
483 SERVER_START_REQ( get_message )
485 req->flags = GET_MSG_REMOVE | GET_MSG_SENT_ONLY;
489 if (!(res = SERVER_CALL()))
491 msg.type = req->type;
492 msg.msg.hwnd = req->win;
493 msg.msg.message = req->msg;
494 msg.msg.wParam = req->wparam;
495 msg.msg.lParam = req->lparam;
496 msg.msg.time = req->time;
497 msg.msg.pt.x = req->x;
498 msg.msg.pt.y = req->y;
499 msg.extraInfo = req->info;
505 handle_sent_message( &msg );
511 /***********************************************************************
514 * See "Windows Internals", p.447
517 * 0 if exit with timeout
520 int QUEUE_WaitBits( WORD bits, DWORD timeout )
525 TRACE_(msg)("q %04x waiting for %04x\n", GetFastQueue16(), bits);
527 hQueue = GetFastQueue16();
528 if (!(queue = QUEUE_Lock( hQueue ))) return 0;
532 unsigned int wake_bits = 0, changed_bits = 0;
535 SERVER_START_REQ( set_queue_mask )
537 req->wake_mask = QS_SENDMESSAGE;
538 req->changed_mask = bits | QS_SENDMESSAGE;
542 wake_bits = req->wake_bits;
543 changed_bits = req->changed_bits;
548 if (changed_bits & bits)
550 /* One of the bits is set; we can return */
551 QUEUE_Unlock( queue );
554 if (wake_bits & QS_SENDMESSAGE)
556 /* Process the sent message immediately */
557 process_sent_messages();
558 continue; /* nested sm crux */
561 TRACE_(msg)("(%04x) mask=%08x, bits=%08x, changed=%08x, waiting\n",
562 queue->self, bits, wake_bits, changed_bits );
564 ReleaseThunkLock( &dwlc );
565 if (dwlc) TRACE_(msg)("had win16 lock\n");
567 if (USER_Driver.pMsgWaitForMultipleObjectsEx)
568 USER_Driver.pMsgWaitForMultipleObjectsEx( 1, &queue->server_queue, timeout, 0, 0 );
570 WaitForSingleObject( queue->server_queue, timeout );
571 if (dwlc) RestoreThunkLock( dwlc );
576 /***********************************************************************
579 * Find a message matching the given parameters. Return FALSE if none available.
581 BOOL QUEUE_FindMsg( HWND hwnd, UINT first, UINT last, BOOL remove, QMSG *msg )
585 if (!first && !last) last = ~0;
589 SERVER_START_REQ( get_message )
591 req->flags = remove ? GET_MSG_REMOVE : 0;
593 req->get_first = first;
594 req->get_last = last;
595 if ((ret = !SERVER_CALL()))
597 msg->kind = req->kind;
598 msg->type = req->type;
599 msg->msg.hwnd = req->win;
600 msg->msg.message = req->msg;
601 msg->msg.wParam = req->wparam;
602 msg->msg.lParam = req->lparam;
603 msg->msg.time = req->time;
604 msg->msg.pt.x = req->x;
605 msg->msg.pt.y = req->y;
606 msg->extraInfo = req->info;
611 if (!ret || (msg->kind != SEND_MESSAGE)) break;
612 handle_sent_message( msg );
615 if (ret) TRACE( "got hwnd %x msg %x (%s) wp %x lp %lx\n",
616 msg->msg.hwnd, msg->msg.message, SPY_GetMsgName(msg->msg.message),
617 msg->msg.wParam, msg->msg.lParam );
623 /***********************************************************************
624 * QUEUE_CleanupWindow
626 * Cleanup the queue to account for a window being deleted.
628 void QUEUE_CleanupWindow( HWND hwnd )
630 SERVER_START_REQ( cleanup_window_queue )
639 /***********************************************************************
642 HTASK16 QUEUE_GetQueueTask( HQUEUE16 hQueue )
646 MESSAGEQUEUE *queue = QUEUE_Lock( hQueue );
650 hTask = queue->teb->htask16;
651 QUEUE_Unlock( queue );
658 /***********************************************************************
659 * PostQuitMessage (USER.6)
661 void WINAPI PostQuitMessage16( INT16 exitCode )
663 PostQuitMessage( exitCode );
667 /***********************************************************************
668 * PostQuitMessage (USER32.@)
670 * PostQuitMessage() posts a message to the system requesting an
671 * application to terminate execution. As a result of this function,
672 * the WM_QUIT message is posted to the application, and
673 * PostQuitMessage() returns immediately. The exitCode parameter
674 * specifies an application-defined exit code, which appears in the
675 * _wParam_ parameter of the WM_QUIT message posted to the application.
681 void WINAPI PostQuitMessage( INT exitCode )
683 PostThreadMessageW( GetCurrentThreadId(), WM_QUIT, exitCode, 0 );
687 /***********************************************************************
688 * GetWindowTask (USER.224)
690 HTASK16 WINAPI GetWindowTask16( HWND16 hwnd )
693 WND *wndPtr = WIN_FindWndPtr( hwnd );
695 if (!wndPtr) return 0;
696 retvalue = QUEUE_GetQueueTask( wndPtr->hmemTaskQ );
697 WIN_ReleaseWndPtr(wndPtr);
701 /***********************************************************************
702 * GetWindowThreadProcessId (USER32.@)
704 DWORD WINAPI GetWindowThreadProcessId( HWND hwnd, LPDWORD process )
709 WND *wndPtr = WIN_FindWndPtr( hwnd );
710 if (!wndPtr) return 0;
712 queue = QUEUE_Lock( wndPtr->hmemTaskQ );
713 WIN_ReleaseWndPtr(wndPtr);
715 if (!queue) return 0;
717 if ( process ) *process = (DWORD)queue->teb->pid;
718 retvalue = (DWORD)queue->teb->tid;
720 QUEUE_Unlock( queue );
725 /***********************************************************************
726 * SetMessageQueue (USER.266)
728 BOOL16 WINAPI SetMessageQueue16( INT16 size )
730 return SetMessageQueue( size );
734 /***********************************************************************
735 * SetMessageQueue (USER32.@)
737 BOOL WINAPI SetMessageQueue( INT size )
739 /* now obsolete the message queue will be expanded dynamically
742 /* access the queue to create it if it's not existing */
748 /***********************************************************************
749 * InitThreadInput (USER.409)
751 HQUEUE16 WINAPI InitThreadInput16( WORD unknown, WORD flags )
754 MESSAGEQUEUE *queuePtr;
756 TEB *teb = NtCurrentTeb();
765 /* Create thread message queue */
766 if( !(hQueue = QUEUE_CreateMsgQueue( TRUE )))
768 ERR_(msg)("failed!\n");
772 /* Link new queue into list */
773 queuePtr = QUEUE_Lock( hQueue );
774 queuePtr->teb = NtCurrentTeb();
776 HeapLock( GetProcessHeap() ); /* FIXME: a bit overkill */
777 SetThreadQueue16( 0, hQueue );
779 HeapUnlock( GetProcessHeap() );
781 QUEUE_Unlock( queuePtr );
787 /***********************************************************************
788 * GetQueueStatus (USER.334)
790 DWORD WINAPI GetQueueStatus16( UINT16 flags )
792 return GetQueueStatus( flags );
795 /***********************************************************************
796 * GetQueueStatus (USER32.@)
798 DWORD WINAPI GetQueueStatus( UINT flags )
802 SERVER_START_REQ( get_queue_status )
806 ret = MAKELONG( req->changed_bits & flags, req->wake_bits & flags );
813 /***********************************************************************
814 * GetInputState (USER.335)
816 BOOL16 WINAPI GetInputState16(void)
818 return GetInputState();
821 /***********************************************************************
822 * GetInputState (USER32.@)
824 BOOL WINAPI GetInputState(void)
828 SERVER_START_REQ( get_queue_status )
832 ret = req->wake_bits & (QS_KEY | QS_MOUSEBUTTON);
838 /***********************************************************************
839 * WaitForInputIdle (USER32.@)
841 DWORD WINAPI WaitForInputIdle (HANDLE hProcess, DWORD dwTimeOut)
844 HANDLE idle_event = -1;
846 SERVER_START_REQ( wait_input_idle )
848 req->handle = hProcess;
849 req->timeout = dwTimeOut;
850 if (!(ret = SERVER_CALL_ERR())) idle_event = req->event;
853 if (ret) return 0xffffffff; /* error */
854 if (!idle_event) return 0; /* no event to wait on */
856 cur_time = GetTickCount();
858 TRACE_(msg)("waiting for %x\n", idle_event );
859 while ( dwTimeOut > GetTickCount() - cur_time || dwTimeOut == INFINITE )
861 ret = MsgWaitForMultipleObjects ( 1, &idle_event, FALSE, dwTimeOut, QS_SENDMESSAGE );
862 if ( ret == ( WAIT_OBJECT_0 + 1 ))
864 process_sent_messages();
867 if ( ret == WAIT_TIMEOUT || ret == 0xFFFFFFFF )
869 TRACE_(msg)("timeout or error\n");
874 TRACE_(msg)("finished\n");
882 /***********************************************************************
883 * UserYield (USER.332)
884 * UserYield16 (USER32.@)
886 void WINAPI UserYield16(void)
888 /* Handle sent messages */
889 process_sent_messages();
894 /* Handle sent messages again */
895 process_sent_messages();
898 /***********************************************************************
899 * GetMessagePos (USER.119) (USER32.@)
901 * The GetMessagePos() function returns a long value representing a
902 * cursor position, in screen coordinates, when the last message
903 * retrieved by the GetMessage() function occurs. The x-coordinate is
904 * in the low-order word of the return value, the y-coordinate is in
905 * the high-order word. The application can use the MAKEPOINT()
906 * macro to obtain a POINT structure from the return value.
908 * For the current cursor position, use GetCursorPos().
912 * Cursor position of last message on success, zero on failure.
919 DWORD WINAPI GetMessagePos(void)
924 if (!(queue = QUEUE_Lock( GetFastQueue16() ))) return 0;
925 ret = queue->GetMessagePosVal;
926 QUEUE_Unlock( queue );
932 /***********************************************************************
933 * GetMessageTime (USER.120) (USER32.@)
935 * GetMessageTime() returns the message time for the last message
936 * retrieved by the function. The time is measured in milliseconds with
937 * the same offset as GetTickCount().
939 * Since the tick count wraps, this is only useful for moderately short
940 * relative time comparisons.
944 * Time of last message on success, zero on failure.
951 LONG WINAPI GetMessageTime(void)
956 if (!(queue = QUEUE_Lock( GetFastQueue16() ))) return 0;
957 ret = queue->GetMessageTimeVal;
958 QUEUE_Unlock( queue );
964 /***********************************************************************
965 * GetMessageExtraInfo (USER.288) (USER32.@)
967 LONG WINAPI GetMessageExtraInfo(void)
972 if (!(queue = QUEUE_Lock( GetFastQueue16() ))) return 0;
973 ret = queue->GetMessageExtraInfoVal;
974 QUEUE_Unlock( queue );
980 /**********************************************************************
981 * AttachThreadInput (USER32.@) Attaches input of 1 thread to other
983 * Attaches the input processing mechanism of one thread to that of
991 * 1. Reset the Key State (currenly per thread key state is not maintained)
993 BOOL WINAPI AttachThreadInput(
994 DWORD idAttach, /* [in] Thread to attach */
995 DWORD idAttachTo, /* [in] Thread to attach to */
996 BOOL fAttach) /* [in] Attach or detach */
998 MESSAGEQUEUE *pSrcMsgQ = 0, *pTgtMsgQ = 0;
1001 SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
1003 /* A thread cannot attach to itself */
1004 if ( idAttach == idAttachTo )
1007 /* According to the docs this method should fail if a
1008 * "Journal record" hook is installed. (attaches all input queues together)
1010 if ( HOOK_IsHooked( WH_JOURNALRECORD ) )
1013 /* Retrieve message queues corresponding to the thread id's */
1014 pTgtMsgQ = QUEUE_Lock( GetThreadQueue16( idAttach ) );
1015 pSrcMsgQ = QUEUE_Lock( GetThreadQueue16( idAttachTo ) );
1017 /* Ensure we have message queues and that Src and Tgt threads
1018 * are not system threads.
1020 if ( !pSrcMsgQ || !pTgtMsgQ || !pSrcMsgQ->pQData || !pTgtMsgQ->pQData )
1023 if (fAttach) /* Attach threads */
1025 /* Only attach if currently detached */
1026 if ( pTgtMsgQ->pQData != pSrcMsgQ->pQData )
1028 /* First release the target threads perQData */
1029 PERQDATA_Release( pTgtMsgQ->pQData );
1031 /* Share a reference to the source threads perQDATA */
1032 PERQDATA_Addref( pSrcMsgQ->pQData );
1033 pTgtMsgQ->pQData = pSrcMsgQ->pQData;
1036 else /* Detach threads */
1038 /* Only detach if currently attached */
1039 if ( pTgtMsgQ->pQData == pSrcMsgQ->pQData )
1041 /* First release the target threads perQData */
1042 PERQDATA_Release( pTgtMsgQ->pQData );
1044 /* Give the target thread its own private perQDATA once more */
1045 pTgtMsgQ->pQData = PERQDATA_CreateInstance();
1049 /* TODO: Reset the Key State */
1051 bRet = 1; /* Success */
1055 /* Unlock the queues before returning */
1057 QUEUE_Unlock( pSrcMsgQ );
1059 QUEUE_Unlock( pTgtMsgQ );