D3DHAL_DP2SETSTREAMSOURCE 구조체(d3dhal.h)

아티클
02/26/2024

DirectX 8.0 이상 버전만 해당합니다.

D3DHAL_DP2SETSTREAMSOURCE 구조체는 꼭짓점 스트림 원본을 D3dDrawPrimitives2의 꼭짓점 버퍼에 바인딩하는 데 사용됩니다.

구문

typedef struct _D3DHAL_DP2SETSTREAMSOURCE {
  DWORD dwStream;
  DWORD dwVBHandle;
  DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCE;

멤버

dwStream

바인딩되는 스트림을 지정합니다. 0과 드라이버에서 지정한 최대 스트림 수 사이의 값이 있습니다.

dwVBHandle

꼭짓점 버퍼 핸들을 지정합니다. 꼭짓점 버퍼 핸들이 0이면 스트림이 더 이상 꼭짓점 버퍼에 바인딩되지 않습니다.

dwStride

꼭짓점 크기(바이트)를 지정합니다.

설명

드라이버는 새 DP2 토큰 D3DDP2OP_SETSTREAMSOURCE 통해 특정 스트림에 꼭짓점 버퍼 바인딩을 알 수 있습니다.

디버그 런타임은 dwStream 이 법적 범위 내에 있지만 소매 버전은 그렇지 않은지 확인하므로 드라이버에 유효성 검사가 있어야 합니다. DirectX 8.0은 지정된 스트림 인덱스가 하드웨어에서 지원하는 최대 스트림보다 큰 경우(D3DCAPS8 MaxStreams 를 통해 보고됨) 드라이버와 하드웨어 조합이 이 경우 오류 또는 중단되지 않도록 요구하는 것 이상으로 드라이버 또는 하드웨어의 동작을 정의하지 않으며 올바른 상태를 복원할 때 드라이버와 하드웨어 조합이 정상적으로 계속 작동해야 합니다. 디스플레이 드라이버의 디버그 버전은 이 문제가 감지된 시기를 나타내는 메시지를 디버그 출력 스트림에 표시해야 합니다.

런타임은 현재 꼭짓점 셰이더에서 액세스하는 스트림이 NULL이 아닌지 확인하지 않습니다. 이 오류 사례가 발생할 때 드라이버/하드웨어가 충돌하지 않도록 하는 것은 드라이버 작성기의 책임입니다. 디스플레이 드라이버의 디버그 버전은 이 문제가 감지된 시기를 나타내기 위해 디버그 출력 스트림에 메시지를 표시해야 합니다.

단일 스트림 원본만 D3DHAL_DP2COMMAND 구조에 의해 설정됩니다. 즉, bCommand가 D3DDP2OP_SETSTREAMSOURCE 경우 D3DHAL_DP2COMMAND wStateCount 필드는 항상 1입니다.