DXGKDDI_GETNODEMETADATA 콜백 함수(d3dkmddi.h)

제공된 어댑터 핸들에서 지정된 GPU 노드에 있는 엔진의 엔진 유형 및 친숙한 이름을 반환합니다. Windows WDDM(디스플레이 드라이버 모델) 1.3 이상 디스플레이 미니포트 드라이버에서 구현해야 합니다.

구문

DXGKDDI_GETNODEMETADATA DxgkddiGetnodemetadata;

NTSTATUS DxgkddiGetnodemetadata(
  [in] IN_CONST_HANDLE hAdapter,
       UINT NodeOrdinalAndAdapterIndex,
       OUT_PDXGKARG_GETNODEMETADATA pGetNodeMetadata
)
{...}

매개 변수

[in] hAdapter

디스플레이 어댑터를 식별하는 핸들입니다. DirectX 그래픽 커널 하위 시스템은 이전에 DxgkDdiStartDevice 함수의 DxgkInterface 매개 변수에 있는 디스플레이 미니포트 드라이버에 이 핸들을 제공했습니다.

NodeOrdinalAndAdapterIndex

엔진 정보를 가져올 노드의 인덱스입니다. 이 노드는 hAdapter 매개 변수에 의해 정의된 실제 어댑터 내에 있습니다.

pGetNodeMetadata

NodeOrdinal 매개 변수로 지정된 엔진의 엔진 유형 및 친숙한 이름을 포함하는 DXGKARG_GETNODEMETADATA 구조체에 대한 포인터입니다.

DXGKARG_GETNODEMETADATA 구조체는 DXGK_NODEMETADATA 구조체로 선언됩니다.

반환 값

다음 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	DxgkDdiGetNodeMetadata 가 엔진 정보를 성공적으로 검색했습니다.
STATUS_INVALID_PARAMETER	호출자가 제공한 hAdapter 또는 pGetNodeMetadata 매개 변수가 잘못되었거나 호출자가 제공한 NodeOrdinal 값이 어댑터의 노드 수보다 크거나 같습니다.

hAdapter 및 pGetNodeMetadata 매개 변수가 유효하고 NodeOrdinal의 값이 0에서 (노드 수 - 1) 범위인 경우 이 함수에 대한 모든 호출이 성공해야 합니다.

설명

이 함수를 구현하는 방법에 대한 자세한 내용은 GPU 엔진 기능 열거를 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows 8.1
지원되는 최소 서버	Windows Server 2012 R2
대상 플랫폼	데스크톱
헤더	d3dkmddi.h(D3dkmddi.h 포함)
IRQL	PASSIVE_LEVEL

참고 항목

DXGK_NODEMETADATA

DxgkDdiStartDevice