Skip to main content
루트 시그니처 레이아웃을 만듭니다.

구문

매개 변수

nodeMask [in]
형식: UINT
단일 GPU 작동의 경우 이 값을 0으로 설정합니다. 여러 GPU 노드가 있는 경우, 루트 시그니처를 적용할 노드(디바이스의 물리적 어댑터)를 식별하는 비트를 설정합니다. 마스크의 각 비트는 하나의 노드에 해당합니다. 멀티 어댑터 시스템을 참조하세요. pBlobWithRootSignature [in]
형식: const void *
직렬화된 시그니처의 원본 데이터에 대한 포인터입니다. blobLengthInBytes [in]
형식: SIZE_T
pBlobWithRootSignature가 가리키는 메모리 블록의 크기(바이트 단위)입니다. riid
형식: const IID &
루트 시그니처 인터페이스의 전역 고유 식별자(GUID)입니다. 설명을 참조하세요. 입력 매개 변수입니다. ppvRootSignature [out]
형식: void **
루트 시그니처에 대한 포인터를 받는 메모리 블록에 대한 포인터입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 Direct3D 12 반환 코드 중 하나를 반환합니다. pBlobWithRootSignature가 가리키는 blob이 유효하지 않은 경우 이 메서드는 E_INVALIDARG를 반환합니다.

설명

애플리케이션이 프로그램적으로 D3D12_ROOT_SIGNATURE_DESC 데이터 구조를 생성하는 경우, 직렬화된 형식을 만들기 위해 이 D3D12_ROOT_SIGNATURE_DESC에 대한 포인터를 D3D12SerializeRootSignature 호출에 전달해야 합니다. 그런 다음 애플리케이션은 ID3D12Device::CreateRootSignature 호출에서 직렬화된 형식을 pBlobWithRootSignature에 전달합니다. 루트 시그니처 레이아웃에 대한 인터페이스의 REFIID 또는 GUID는 __uuidof() 매크로를 사용하여 얻을 수 있습니다. 예를 들어, __uuidof(ID3D12RootSignature)는 루트 시그니처에 대한 인터페이스의 GUID를 가져옵니다.

예제

D3D12HelloTriangle 샘플은 다음과 같이 ID3D12Device::CreateRootSignature를 사용합니다: 빈 루트 시그니처를 만듭니다.

요구 사항

헤더: d3d12_xs.h 또는 d3d12_x.h
라이브러리: d3d12_xs.lib 또는 d3d12_x.lib
지원 플랫폼: XBOX Series 콘솔 및 XBOX One 제품군

함께 보기

ID3D12Device
마지막 수정일 2026년 8월 24일