IDirect3DDevice9::D rawIndexedPrimitiveUP 메서드(d3d9helper.h)

  • 아티클

사용자 메모리 포인터로 지정된 데이터를 사용하여 지정된 기하학적 기본 형식을 렌더링합니다.

구문

HRESULT DrawIndexedPrimitiveUP(
  [in] D3DPRIMITIVETYPE PrimitiveType,
  [in] UINT             MinVertexIndex,
  [in] UINT             NumVertices,
  [in] UINT             PrimitiveCount,
  [in] const void       *pIndexData,
  [in] D3DFORMAT        IndexDataFormat,
  [in] const void       *pVertexStreamZeroData,
  [in] UINT             VertexStreamZeroStride
);

매개 변수

[in] PrimitiveType

형식: D3DPRIMITIVETYPE

렌더링할 기본 형식을 설명하는 D3DPRIMITIVETYPE 열거형 형식의 멤버입니다.

[in] MinVertexIndex

형식: UINT

최소 꼭짓점 인덱스입니다. 0부터 시작하는 인덱스입니다.

[in] NumVertices

형식: UINT

이 호출 중에 사용되는 꼭짓점 수입니다. 첫 번째 꼭짓점은 인덱스 MinVertexIndex에 있습니다.

[in] PrimitiveCount

형식: UINT

렌더링할 기본 형식의 수입니다. 허용되는 최대 기본 형식 수는 D3DCAPS9 구조체의 MaxPrimitiveCount 멤버를 확인하여 결정됩니다(인덱스 수는 기본 개수 및 기본 형식의 함수임).

[in] pIndexData

형식: const void*

인덱스 데이터에 대한 사용자 메모리 포인터입니다.

[in] IndexDataFormat

형식: D3DFORMAT

인덱스 데이터의 형식을 설명하는 D3DFORMAT 열거형 형식의 멤버입니다. 유효한 설정은 다음과 같습니다.

[in] pVertexStreamZeroData

형식: const void*

꼭짓점 데이터에 대한 사용자 메모리 포인터입니다. 꼭짓점 데이터는 스트림 0에 있어야 합니다.

[in] VertexStreamZeroStride

형식: UINT

각 꼭짓점의 데이터 바이트 수입니다. 이 값은 0이 아닐 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값은 D3DERR_INVALIDCALL 수 있습니다.

설명

이 메서드는 꼭짓점 버퍼에 해당 꼭짓점 데이터를 저장할 수 없는 애플리케이션에서 사용하기 위한 것입니다. 이 메서드는 스트림 0으로 선언해야 하는 단일 꼭짓점 스트림만 지원합니다.

IDirect3DDevice9::D rawIndexedPrimitiveUP 호출에 따라 IDirect3DDevice9::GetStreamSource에서 참조하는 스트림 0 설정이 NULL로 설정됩니다. 또한 IDirect3DDevice9::SetIndices에 대한 인덱스 버퍼 설정이 NULL로 설정됩니다.

IDirect3DDevice9::D rawIndexedPrimitiveUP에 전달된 꼭짓점 데이터는 호출 후에 유지할 필요가 없습니다. Direct3D는 호출에서 반환하기 전에 해당 데이터에 대한 액세스를 완료합니다.

레거시 애플리케이션을 Direct3D 9로 변환할 때 고정 함수 파이프라인을 사용하도록 IDirect3DDevice9::SetFVF 에 대한 호출을 추가하거나 그리기 호출을 하기 전에 꼭짓점 셰이더를 사용하려면 IDirect3DDevice9::SetVertexDeclaration 을 추가해야 합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 d3d9helper.h(D3D9.h 포함)
라이브러리 D3D9.lib

추가 정보

IDirect3DDevice9

IDirect3DDevice9::DrawPrimitive

꼭짓점 및 인덱스 버퍼에서 렌더링(Direct3D 9)