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

# OpenWaitHandle

> IGameInputDispatcher::OpenWaitHandle

# IGameInputDispatcher::OpenWaitHandle

返回一个等待句柄，当调度程序队列中有工作可用时发出信号。

## 语法

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

### 参数

*waitHandle*   \_Outptr\_result\_nullonfailure\_\
类型：HANDLE\*

返回的等待句柄。

### 返回值

类型：HRESULT

函数结果

### 备注

`IGameInputDispatcher::OpenWaitHandle` 返回一个等待句柄。此方法在调度程序队列中有工作可用时发出信号。当不再需要该句柄时，请对该句柄调用 [CloseHandle](https://learn.microsoft.com/windows/desktop/api/handleapi/nf-handleapi-closehandle) 函数。有关 GameInput API 的中级和高级用例，请参阅 [高级 GameInput 主题](https://docs.xbox.com/zh-CN/build/core-features/common/input/advanced/input-advanced-topics.md)。

## 要求

**标头：** GameInput.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[GameInput 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDispatcher](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/IGameInputDispatcher/igameinputdispatcher.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v0** | 引入。 |


## Related topics

- [IGameInput::CreateDispatcher](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)
- [GameInput 工作队列](https://docs.xbox.com/zh-CN/build/core-features/common/input/advanced/input-work-queues.md)
- [Wait](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_wait_public.md)
- [Open Trade](https://docs.xbox.com/api-reference/trading/open-trade.md)
- [OpenSharedHandle](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_opensharedhandle_public.md)