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

# CreateMetaCommand (XBOX Series 콘솔)

> 지정된 메타 명령의 인스턴스를 만듭니다.

지정된 메타 명령의 인스턴스를 만듭니다.

## 구문

```cpp theme={null}
HRESULT CreateMetaCommand(
    const GUID & CommandId,
    UINT NodeMask,
    const void  pCreationParametersData,
    SIZE_T CreationParametersDataSizeInBytes,
    const IID & riid,
    void  ppMetaCommand
)
```

### 매개 변수

*CommandId \[in]*\
형식: const GUID &

인스턴스화하려는 메타 명령의 전역 고유 식별자(GUID)에 대한 참조입니다.

*NodeMask \[in]*\
형식: UINT

단일 어댑터 작업의 경우 이 값을 0으로 설정합니다. 여러 어댑터 노드가 있는 경우 메타 명령이 적용되는 노드(디바이스의 실제 어댑터 중 하나)를 식별하기 위해 비트를 설정합니다. 마스크의 각 비트는 단일 노드에 해당합니다. 1비트만 설정해야 합니다. [다중 어댑터 시스템](https://learn.microsoft.com/en-us/windows/win32/direct3d12/multi-engine)을 참조하세요.

*pCreationParametersData \[in, optional]*\
형식: const void \*

메타 명령을 만들기 위한 매개 변수 값을 포함하는 상수 구조체에 대한 선택적 포인터입니다.

*CreationParametersDataSizeInBytes \[in]*\
형식: SIZE\_T

<i>pCreationParametersData</i>가 설정된 경우 이 매개 변수가 가리키는 구조체의 크기를 포함하는 [SIZE\_T](https://learn.microsoft.com/en-us/windows/win32/WinProg/windows-data-types)이며, 그렇지 않으면 0입니다.

*riid*\
형식: const IID &

<i>ppMetaCommand</i>에서 반환하려는 인터페이스의 전역 고유 식별자(GUID)에 대한 참조입니다. 이는 [ID3D12MetaCommand](/reference/graphics/d3d12/interfaces/id3d12metacommand/id3d12metacommand_public)의 GUID일 것으로 예상됩니다.

*ppMetaCommand \[out]*\
형식: void \*\*

메타 명령에 대한 포인터를 받는 메모리 블록에 대한 포인터입니다. 이것은 생성된 메타 명령을 나타내는 [ID3D12MetaCommand](/reference/graphics/d3d12/interfaces/id3d12metacommand/id3d12metacommand_public)에 대한 포인터의 주소입니다.

### 반환 값

형식: HRESULT

이 메서드가 성공하면 **S\_OK**를 반환합니다. 그렇지 않으면 **HRESULT** 오류 코드를 반환합니다.

<table>
  <tr>
    <th>반환 값</th>
    <th>설명</th>
  </tr>

  <tr>
    <td width="40%">
      <dl>
        <dt>DXGI\_ERROR\_UNSUPPORTED</dt>
      </dl>
    </td>

    <td width="60%">
      현재 하드웨어가 요청되는 알고리즘을 지원하지 않습니다.
    </td>
  </tr>
</table>

## 요구 사항

**헤더:** d3d12\_xs.h\
**라이브러리:** d3d12\_xs.lib\
**지원 플랫폼**: XBOX Series 콘솔

## 함께 보기

[ID3D12Device5](/reference/graphics/d3d12/interfaces/id3d12device5/id3d12device5_public)


## Related topics

- [InitializeMetaCommand (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_initializemetacommand_public.md)
- [EnumerateMetaCommands (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_enumeratemetacommands_public.md)
- [EnumerateMetaCommandParameters (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_enumeratemetacommandparameters_public.md)
- [CreateCommandQueue1 (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public.md)
- [CreateCommandList1 (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createcommandlist1_public.md)