GetADLXGPUFromBdf
Navigation: ADLX SDK References → ADLX Interfaces → Miscellaneous → IADLMapping
Syntax
ADLX_RESULT GetADLXGPUFromBdf (adlx_int bus, adlx_int device, adlx_int function, IADLXGPU** ppGPU)
Parameters
| # | Direction | Name | Type | Description |
|---|---|---|---|---|
| 1. | [in] | bus | adlx_int | The unique PCIE bus number of the requested GPU. |
| # | Direction | Name | Type | Description |
| --- | --- | --- | --- | --- |
| 2. | [in] | device | adlx_int | The device number of the requested GPU. |
| # | Direction | Name | Type | Description |
| --- | --- | --- | --- | --- |
| 3. | [in] | function | adlx_int | The function number of the requested GPU. |
| # | Direction | Name | Type | Description |
| --- | --- | --- | --- | --- |
| 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.
Remarks
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.
Requirements
| Header | include “ADLXDefines.h” |
|---|---|
| Minimum version | 1.0 |
See Also: IADLXGPU, Release, ADLX Enums