TPGetWaitEvent (Windows Embedded CE 6.0)

1/6/2010

This function gets a handle to an event that indicates the TileHost window should be updated.

Syntax

HRESULT TPGetWaitEvent(
    HANDLE hTileProxy,
  HANDLE* phEvent)

Parameters

• hTileProxy
  [in] Handle to the proxy (TileProxy) for the host Web browser window.

• phEvent
  [out] Pointer to handle of the event object.

Return Value

This function returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, in addition to the following:

• S_OK
  The method completed successfully.

Remarks

You can then use this event handle with the timeout value that TPGetWaitTimeout returns to call the MsgWaitForMultipleObjectsEx function and update the window once the event is in the signaled state.

Example

The following code example shows how to use TPGetWaitEvent to update the tiling engine window when appropriate.

HANDLE hTileProxy;
CreateTileProxy(hWnd, hHtml, pfnWndProc, NULL, &hTileProxy);    
    
HANDLE handles[1];
UINT32 itimeout;
MSG msg;
bool running = true;
TPGetWaitEvent(hTileProxy, & handles[0]);
    while (running)
    {
        TPGetWaitTimeout(hTileProxy, &iTimeout);
        MsgWaitForMultipleObjectsEx(1, handles, timeout, QS_ALLINPUT, MWMO_INPUTAVAILABLE);
        while (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE | PM_NOYIELD))
        {
            DispatchMessage(&msg);
            
            if (msg.message == WM_QUIT)
            {
                running = false;
                break;
            }
        }
        
        TPUpdate(hTileProxy);
    }

Requirements

See Also

Other Resources

Internet Explorer Embedded Tiling Engine Functions
Error Values