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

# IGameInputRawDeviceReport::GetRawData

> IGameInputRawDeviceReport::GetRawData

# IGameInputRawDeviceReport::GetRawData

以原始位元組形式擷取報告緩衝區內容。

## 語法

```cpp theme={null}
size_t GetRawData(
    size_t bufferSize,
    void* buffer
)
```

### 參數

*bufferSize*   \_In\_<br />
類型：size\_t

傳入 `GetRawData` 的緩衝區大小。

*buffer*   \_Out\_writes\_(bufferSize)<br />
類型：void\*

使用者建立、會隨原始資料一起傳回的緩衝區。

### 傳回值

類型：size\_t

針對遊戲輸入通訊協定 (GIP) 裝置，傳回寫入呼叫端緩衝區的位元組數目。

## 備註

`IGameInputRawDeviceReport::GetRawData` 方法可讓應用程式以原始位元組形式讀取報告緩衝區內容。呼叫端通常會傳入大小與 [GetRawDataSize](/zh-TW/reference/input/gameinput/interfaces/igameinputrawdevicereport/methods/igameinputrawdevicereport_getrawdatasize) 方法傳回值相符的緩衝區。不過，`GetRawData` 方法接受任何大小的緩衝區。如果緩衝區太小，輸出只會被截斷。`GetRawData` 方法的傳回值表示寫入呼叫端緩衝區的位元組數目。只有在提供的緩衝區大於所需大小時，此值才會與 `bufferSize` 參數的值不同。

## 需求

**標頭：** GameInput.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[進階 GameInput 主題](/zh-TW/build/core-features/common/input/advanced/input-advanced-topics)\
[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[IGameInputRawDeviceReport](/zh-TW/reference/input/gameinput/interfaces/igameinputrawdevicereport/igameinputrawdevicereport)


## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v3** | 重新推出。 |
| **v1** | 隨 IGameInputRawDeviceReport 介面一併移除。 |
| **v0** | 推出。 |


## Related topics

- [IGameInputRawDeviceReport::GetRawDataSize](/zh-TW/reference/input/gameinput/interfaces/igameinputrawdevicereport/methods/igameinputrawdevicereport_getrawdatasize.md)
- [IGameInputRawDeviceReport](/zh-TW/reference/input/gameinput/interfaces/igameinputrawdevicereport/igameinputrawdevicereport.md)
- [IGameInputRawDeviceReport::SetRawData](/zh-TW/reference/input/gameinput/interfaces/igameinputrawdevicereport/methods/igameinputrawdevicereport_setrawdata.md)
- [IGameInputRawDeviceReport::GetDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputrawdevicereport/methods/igameinputrawdevicereport_getdevice.md)
- [IGameInputRawDeviceReport::GetReportInfo](/zh-TW/reference/input/gameinput/interfaces/igameinputrawdevicereport/methods/igameinputrawdevicereport_getreportinfo.md)
