DXGKDDI_GETNODEMETADATA callback function (d3dkmddi.h)

From a provided adapter handle, DXGKDDI_GETNODEMETADATA returns the metadata of an engine on a specified GPU node.

Syntax

DXGKDDI_GETNODEMETADATA DxgkddiGetnodemetadata;

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

Parameters

[in] hAdapter

[in] A handle that identifies a display adapter. Dxgkrnl previously provided this handle to the display miniport driver (KMD) in the DxgkInterface parameter of the DxgkDdiStartDevice function.

NodeOrdinalAndAdapterIndex

[in] An index of a node for which engine information is obtained. This node is within the physical adapter defined by the hAdapter parameter.

pGetNodeMetadata

[out] Pointer to a DXGKARG_GETNODEMETADATA structure in which KMD returns the metadata of the engine specified by NodeOrdinal.

Note that the DXGKARG_GETNODEMETADATA structure is declared as a DXGK_NODEMETADATA structure.

Return value

Returns one of the following values:

If the hAdapter and pGetNodeMetadata parameters are valid, and NodeOrdinal has a value in the range of 0 to (number of nodes - 1), all calls to this function must be successful.

Remarks

KMD sets the bits for every feature that the specified GPU node supports. The OS allows UMD to use only those metadata capabilities that KMD reports support for.

WDDM 1.3 and later display miniport drivers (KMDs) must implement DXGKDDI_GETNODEMETADATA.

For more information on how to implement this function, see Enumerating GPU engine capabilities.

Requirements

See also

DXGK_NODEMETADATA

DxgkDdiStartDevice