IDirect3DDevice9::SetStreamSource 메서드(d3d9.h)

2023-08-23

꼭짓점 버퍼를 디바이스 데이터 스트림에 바인딩합니다. 자세한 내용은 Stream 원본 설정(Direct3D 9)을 참조하세요.

구문

HRESULT SetStreamSource(
  [in] UINT                   StreamNumber,
  [in] IDirect3DVertexBuffer9 *pStreamData,
  [in] UINT                   OffsetInBytes,
  [in] UINT                   Stride
);

매개 변수

[in] StreamNumber

형식: UINT

0에서 최대 스트림 수 -1까지의 범위에서 데이터 스트림을 지정합니다.

[in] pStreamData

형식: IDirect3DVertexBuffer9*

지정된 데이터 스트림에 바인딩할 꼭짓점 버퍼를 나타내는 IDirect3DVertexBuffer9 인터페이스에 대한 포인터입니다.

[in] OffsetInBytes

형식: UINT

스트림의 시작 부분에서 꼭짓점 데이터의 시작 부분까지의 오프셋(바이트)입니다. 디바이스가 스트림 오프셋을 지원하는지 확인하려면 D3DDEVCAPS2 D3DDEVCAPS2_STREAMOFFSET 상수를 참조하세요.

[in] Stride

형식: UINT

구성 요소의 Stride(바이트)입니다. 설명 부분을 참조하세요.

반환 값

형식: HRESULT

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

설명

FVF 꼭짓점 셰이더를 사용하는 경우 꼭짓점 스트림의 보폭은 FVF에서 계산된 꼭짓점 크기와 일치해야 합니다. 선언을 사용하는 경우 stride는 선언에서 계산된 스트림 크기보다 크거나 같아야 합니다.

SetStreamSource를 호출하는 경우 일반적으로 스트라이드가 꼭짓점 크기와 같아야 합니다. 그러나 동일하거나 유사한 기하 도형의 여러 인스턴스를 그릴 수 있는 경우가 있습니다(예: 인스턴싱을 사용하여 그리는 경우). 이 경우 0 보폭을 사용하여 꼭짓점 버퍼 오프셋을 증가시키지 않도록 런타임에 지시합니다(예: 모든 인스턴스에 동일한 꼭짓점 데이터 사용). 인스턴스화에 대한 자세한 내용은 Geometry의 여러 인스턴스를 효율적으로 그리기(Direct3D 9)를 참조하세요.