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

아티클
02/27/2024

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