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

# D3D12_INPUT_ELEMENT_DESC

> 描述圖形管線之輸入組合器階段的單一元素。

描述圖形管線之輸入組合器階段的單一元素。

## 語法

```cpp theme={null}
typedef struct D3D12_INPUT_ELEMENT_DESC
{
    LPCSTR SemanticName;
    UINT SemanticIndex;
    DXGI_FORMAT Format;
    UINT InputSlot;
    UINT AlignedByteOffset;
    D3D12_INPUT_CLASSIFICATION InputSlotClass;
    UINT InstanceDataStepRate;
} D3D12_INPUT_ELEMENT_DESC
```

### 成員

*SemanticName*\
類型：LPCSTR

在著色器輸入簽章中與此元素相關聯的 HLSL 語意。如需詳細資訊，請參閱 [HLSL 語意](https://learn.microsoft.com/en-us/windows/win32/direct3dhlsl/dx-graphics-hlsl-semantics)。

*SemanticIndex*\
類型：UINT

元素的語意索引。語意索引會以整數索引號碼修飾語意。只有在
有多個元素具有相同語意的情況下，才需要語意索引。例如，4x4 矩陣會有四個元件，每個元件的語意
名稱都是 **matrix**，但這四個元件各自會有不同的語意索引 (0、1、2 和 3)。

*Format*\
類型：DXGI\_FORMAT

[DXGI\_FORMAT](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format) 類型的值，指定元素資料的格式。

*InputSlot*\
類型：UINT

識別輸入組合器的整數值。如需詳細資訊，請參閱[輸入槽](https://learn.microsoft.com/en-us/windows/desktop/direct3d11/d3d10-graphics-programming-guide-input-assembler-stage-getting-started)。有效值介於 0 到 15 之間。

*AlignedByteOffset*\
類型：UINT

選用。從頂點開頭到此元素的位移 (以位元組為單位)。為了方便起見，可使用 D3D12\_APPEND\_ALIGNED\_ELEMENT (0xffffffff) 將目前元素直接定義
在前一個元素之後，必要時包括任何封裝。

*InputSlotClass*\
類型：D3D12\_INPUT\_CLASSIFICATION

識別單一輸入槽之輸入資料類別的值。

*InstanceDataStepRate*\
類型：UINT

在緩衝區中前進一個元素之前，使用相同的每一執行個體資料繪製的執行個體數目。對於包含每一頂點資料的元素，此值必須為 0
(槽類別設定為 [D3D12\_INPUT\_CLASSIFICATION](/zh-TW/reference/graphics/d3d12/enums/d3d12_input_classification_public) 的 D3D12\_INPUT\_PER\_VERTEX\_DATA 成員)。

## 備註

此結構是 [D3D12\_INPUT\_LAYOUT\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_input_layout_desc_public) 結構的成員。管線狀態物件包含輸入配置結構，定義從輸入槽讀取的一個元素。

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機與 XBOX One 系列

## 另請參閱

[核心結構](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [D3D12_INPUT_LAYOUT_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_input_layout_desc_public.md)
- [D3D12_INPUT_CLASSIFICATION](/zh-TW/reference/graphics/d3d12/enums/d3d12_input_classification_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/zh-TW/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [D3D12_RAYTRACING_GEOMETRY_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_desc_public.md)
- [D3D12_RAYTRACING_GEOMETRY_AABBS_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_aabbs_desc_public.md)