DXGKARG_QUERYFEATUREINTERFACE 구조체(d3dkmddi.h)

아티클
05/23/2024

DXGKARG_QUERYFEATUREINTERFACEDxgkDdiQueryFeatureInterface 함수에 대한 매개 변수입니다.

구문

typedef struct _DXGKARG_QUERYFEATUREINTERFACE {
  DXGK_FEATURE_ID      FeatureId;
  DXGK_FEATURE_VERSION Version;
  UINT16               InterfaceSize;
  void                 *Interface;
} DXGKARG_QUERYFEATUREINTERFACE;

멤버

FeatureId

[in] 인터페이스가 쿼리되는 기능의 ID를 지정하는 DXGK_FEATURE_ID 열거형 값입니다.

Version

[in] 인터페이스가 쿼리되는 기능의 버전입니다. 설명 부분을 참조하세요.

InterfaceSize

[in/out] 인터페이스 가 가리키는 인터페이스 버퍼의 크기(바이트)입니다. 성공하면 이 값을 반환된 인터페이스의 크기로 설정해야 합니다. 출력 값이 요청된 인터페이스의 입력 크기보다 작은 경우 호출자는 STATUS_BUFFER_TOO_SMALL 같은 오류를 반환해야 합니다.

Interface

[in/out] 채울 인터페이스 버퍼에 대한 포인터입니다. 이 버퍼는 정확히 InterfaceSize 바이트 길이로 보장됩니다.

설명

기능 인터페이스는 이전 버전의 동일한 인터페이스와 호환될 필요가 없습니다. 예를 들어 기능의 버전 1 및 버전 2에 대한 인터페이스는 근본적으로 다를 수 있습니다(즉, v2 인터페이스는 v1 인터페이스의 확장일 필요가 없음). 이는 DDI를 영구적으로 지원할 필요 없이 시간이 지남에 따라 기능 디자인이 반복될 때 기능 가져오기에 유용합니다.

특정 버전에 대한 기능의 인터페이스는 설명서의 어딘가에 영원히 정의될 수 있지만 OS 및 드라이버는 사용되지 않는 이전 인터페이스를 지원할 필요성을 줄이기 위해 지원되는 기능의 하한(최소) 버전을 설정할 수 있습니다.

자세한 내용은 WDDM 기능 지원 및 사용 쿼리를 참조하세요.