> ## 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.

# EnqueueRequest

> IDStorageQueueX::EnqueueRequest

# IDStorageQueueX::EnqueueRequest

将读取请求入队。

## Syntax

```cpp theme={null}
void EnqueueRequest(  
         const DSTORAGE_REQUEST *request  
)  
```

### Parameters

*request*\
类型：[DSTORAGE\_REQUEST](https://docs.xbox.com/zh-CN/reference/system/dstorage/structs/dstorage_request.md)

要入队的读取请求。

### Return value

类型：void

## Remarks

此方法将 *request* 中的数据入队。方法返回后，[DSTORAGE\_REQUEST](https://docs.xbox.com/zh-CN/reference/system/dstorage/structs/dstorage_request.md) 结构即可被重用。

如果 `EnqueueRequest` 方法自上次提交以来填充了队列容量的一半，则在 `EnqueueRequest` 调用中会触发一次自动提交。

在大多数情况下，此方法只是向队列执行一次内存写入，因此所占用的 CPU 时间很少。但是，如果触发了自动提交，则会占用明显更多的 CPU 时间，包括一次内核模式切换以及在调用方线程中处理所有先前已提交的请求。

如果不希望发生自动提交，建议游戏使用容量足够大的队列，并在合适的时机手动调用 [Submit](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)。

有关详细信息，请参阅 [DirectStorage 概述](https://docs.xbox.com/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md) 中的“EnqueueRequest”一节。

## Requirements

**头文件：** dstorage\_xs.h

**库：** dstorage\_xs.lib

**受支持的平台：** XBOX Series 主机

## See also

[IDStorageQueueX](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex.md)\
[DStorage](https://docs.xbox.com/zh-CN/reference/system/dstorage/dstorage_members.md)


## Related topics

- [DirectStorage 概述](https://docs.xbox.com/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md)
- [DSTORAGE_REQUEST](https://docs.xbox.com/zh-CN/reference/system/dstorage/structs/dstorage_request.md)
- [DSTORAGE_REQUEST_OPTIONS](https://docs.xbox.com/zh-CN/reference/system/dstorage/structs/dstorage_request_options.md)
- [Submit](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)
- [IDStorageQueueX（接口内容）](https://docs.xbox.com/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex.md)