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

# XblPresenceRecordGetDeviceRecords

> XblPresenceRecordGetDeviceRecords

# XblPresenceRecordGetDeviceRecords

获取与返回的状态记录关联的设备状态记录。

## 语法

```cpp theme={null}
HRESULT XblPresenceRecordGetDeviceRecords(  
         XblPresenceRecordHandle handle,  
         const XblPresenceDeviceRecord** deviceRecords,  
         size_t* deviceRecordsCount  
)  
```

### 参数

*handle*   \_In\_\
类型：[XblPresenceRecordHandle](/reference/live/xsapi-c/presence_c/handles/xblpresencerecordhandle)

从 GetPresence API 返回的状态记录句柄。

*deviceRecords*   \_Out\_\
类型：[XblPresenceDeviceRecord\*\*](/reference/live/xsapi-c/presence_c/structs/xblpresencedevicerecord)

回传指向设备状态记录数组的指针。返回的指针数组的内存在 XblPresenceRecordHandle 对象关闭之前始终有效。

*deviceRecordsCount*   \_Out\_\
类型：size\_t\*

回传返回数组的大小。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 要求

**头文件：** presence\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[presence\_c](/reference/live/xsapi-c/presence_c/presence_c_members)


## Related topics

- [XblPresenceDeviceRecord](/zh-CN/reference/live/xsapi-c/presence_c/structs/xblpresencedevicerecord.md)
- [获取用户的 Presence](/zh-CN/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)
- [XblPresenceTitleRecord](/zh-CN/reference/live/xsapi-c/presence_c/structs/xblpresencetitlerecord.md)
- [XblPresenceRecordGetXuid](/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetxuid.md)
- [XblPresenceRecordGetUserState](/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetuserstate.md)