Gets the reference counted IADLXGPU interface corresponding to the GPU with the specified PCI bus number, device number, and function number.



ADLX_RESULT     GetADLXGPUFromBdf (adlx_int bus, adlx_int device, adlx_int function, IADLXGPU ** ppGPU)


  1. [in] bus adlx_int The unique PCIE bus number of the requested GPU.

  2. [in] device adlx_int The device number of the requested GPU.

  3. [in] function adlx_int The function number of the requested GPU.

  4. [out] ppGPU IADLXGPU** The address of the pointer to the returned interface. If the GPU was not found, the method sets the dereferenced address *ppGPU to nullptr.

Return Value

If the IADLXGPU is successfully returned, ADLX_OK is returned.

If the IADLXGPU is not returned, an error code is returned.

Refer to ADLX_RESULT for success codes and error codes.


GetADLXGPUFromBdf is used when an ADLX method must be called for a GPU obtained from ADL where an AdapterInfo structure is available.

The PCI bus number, device number, and function number parameters correspond to ADL AdapterInfo.iBusNumber, AdapterInfo.iDeviceNumber, and AdapterInfo.iFunctionNumber for that GPU.

The returned interface must be discarded with Release when it is no longer needed.

Additional Info

In C++ when using a smart pointer for the returned interface there is no need to call Release because the smart pointer calls it internally.




Minimum version