DD_GETDRIVERSTATEDATA 구조체(ddrawint.h)

아티클
08/23/2023

DD_GETDRIVERSTATEDATA 구조체는 드라이버의 상태를 설명합니다.

구문

typedef struct _DD_GETDRIVERSTATEDATA {
  DWORD   dwFlags;
  union {
    PDD_DIRECTDRAW_GLOBAL lpDD;
    DWORD_PTR             dwhContext;
  };
  LPDWORD lpdwStates;
  DWORD   dwLength;
  HRESULT ddRVal;
} *PDD_GETDRIVERSTATEDATA, DD_GETDRIVERSTATEDATA;

멤버

dwFlags

요청된 데이터를 나타내는 플래그 집합을 지정합니다. 이 매개 변수는 다음 플래그 중 하나로 설정할 수 있습니다.

플래그	의미
D3DDEVINFOID_D3DTEXTUREMANAGER	D3DDEVINFO_TEXTUREMANAGER 구조에서 Direct3D 런타임에서 수행하는 텍스처 관리 정보를 요청합니다.
D3DDEVINFOID_TEXTUREMANAGER	D3DDEVINFO_TEXTUREMANAGER 구조에서 드라이버 또는 Direct3D 런타임에서 수행하는 텍스처 관리 정보를 요청합니다.
D3DDEVINFOID_TEXTURING	D3DDEVINFO_TEXTURING 구조에서 애플리케이션의 텍스처 작업 정보를 요청합니다.
D3DDEVINFOID_VCACHE	DirectX 8.1 버전만 D3DDEVINFO_VCACHE 구조에서 꼭짓점 캐시 정보를 요청합니다.

lpDD

디바이스를 설명하는 DD_DIRECTDRAW_GLOBAL 구조를 가리킵니다.

dwhContext

정보가 요청되는 컨텍스트의 ID를 지정합니다.

lpdwStates

드라이버에서 채울 Direct3D 드라이버 상태 데이터를 가리킵니다. 예를 들어 D3DDEVINFOID_VCACHE dwFlags 멤버에 지정된 경우 드라이버는 lpdwStates 멤버를 꼭짓점 캐시 정보가 포함된 D3DDEVINFO_VCACHE 구조를 가리킵니다.

dwLength

드라이버에서 채울 상태 데이터의 길이(바이트)를 지정합니다.

ddRVal

드라이버가 D3dGetDriverState 콜백의 반환 값을 쓰는 위치를 지정합니다. D3D_OK 반환 코드는 성공을 나타냅니다. 자세한 내용은 Direct3D 드라이버 콜백에 대한 반환 코드를 참조하세요.

설명

애플리케이션은 IDirect3DDevice7::GetInfo 메서드를 사용하고 D3DDEVINFOID_D3DTEXTUREMANAGER, D3DDEVINFOID_TEXTUREMANAGER 및 D3DDEVINFOID_TEXTURING 플래그를 지정하여 텍스처 정보를 검색할 수 있습니다. 이 메서드 및 이러한 플래그와 관련된 구조에 대한 자세한 내용은 DirectX SDK 설명서를 참조하세요. 그런 다음 런타임은 이러한 플래그를 드라이버에 전달합니다.

DirectX 8.1 버전만 해당합니다.Direct3D 런타임은 dwFlags 멤버의 D3DDEVINFOID_VCACHE 플래그를 지정하여 lpDD 멤버에 지정된 드라이버에서 꼭짓점 캐시 정보를 검색합니다. 드라이버는 이 정보를 D3DDEVINFO_VCACHE 구조체에 지정하고 lpdwStates 멤버에서 반환합니다.

DirectX 9.0 이상 버전만 해당합니다. Direct3D 런타임은 드라이버의 D3dDrawPrimitives2 콜백 호출에서 D3DDP2OP_CREATEQUERY 및 D3DDP2OP_ISSUEQUERY 명령과 D3DQUERYTYPE_VCACHE 쿼리 형식을 사용하여 드라이버에 꼭짓점 캐시 정보를 비동기적으로 쿼리합니다. 자세한 내용은 D3DDEVINFO_VCACHE.

참고 D3DDEVINFOID_VCACHE 플래그는 d3dhal.h; dwFlags 에서 설정할 수 있는 다른 플래그는 d3dtypes.h로 정의됩니다.