> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInputDispatcher::OpenWaitHandle

> IGameInputDispatcher::OpenWaitHandle

# IGameInputDispatcher::OpenWaitHandle

Returns a wait handle that signals when work is available in the dispatcher queue.

## Syntax

```cpp theme={null}
HRESULT OpenWaitHandle(
    HANDLE* waitHandle
);
```

### Parameters

*waitHandle*   \_Outptr\_result\_nullonfailure\_\
Type: HANDLE\*

The wait handle that is returned.

### Return value

Type: HRESULT

Function result

### Remarks

The `IGameInputDispatcher::OpenWaitHandle` returns a wait handle. This method signals when work is available in the dispatcher queue. Call the  [CloseHandle](https://learn.microsoft.com/windows/desktop/api/handleapi/nf-handleapi-closehandle) function on the handle when it is no longer needed. For intermediate and advanced use-cases of the GameInput API, see [Advanced GameInput topics](/build/core-features/common/input/advanced/input-advanced-topics).

## Requirements

**Header:** GameInput.h

**Library:** xgameruntime.lib

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## See also

[Overview of GameInput](/build/core-features/common/input/overviews/input-overview)\
[IGameInputDispatcher](/reference/input/gameinput/interfaces/IGameInputDispatcher/igameinputdispatcher)

## Version History

| Version | Changes     |
| ------- | ----------- |
| **v0**  | Introduced. |


## Related topics

- [IGameInput::CreateDispatcher](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)
- [IGameInputDispatcher](/reference/input/gameinput/interfaces/IGameInputDispatcher/igameinputdispatcher.md)
- [GameInput work queues](/build/core-features/common/input/advanced/input-work-queues.md)
- [IGameInputDispatcher::Dispatch](/reference/input/gameinput/interfaces/IGameInputDispatcher/methods/igameinputdispatcher_dispatch.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)