Skip to content

Using ADLX in a Windows system service application

Navigation: Programming with ADLX → ADLX Programming Guide → Advanced Configurations

ADLX v1.4 and above can be used directly in a Windows system service application, providing access to limited ADLX functionality.

To use ADLX directly in a Windows system services application, a user must be logged to the local computer.

When the user logs off, ADLX is no longer functional in the system service application.

Any ADLX functions and methods called after the user log off will return ADLX_ORPHAN_OBJECTS. Any interface obtained from ADLX must be discarded and ADLX must be terminated. After a user logs on again, ADLX must be re-initialized.

For more information on using ADLX directly into a Windows system service application, see GPUServiceDirect C++ sample and GPUServiceDirect C sample.

Note: When running in Session 0, ADLX cannot be initialized with an ADL context.

See Using ADLX in an ADL application for more information for initializing ADLX with an ADL context.

Refer to ADLX v1.3 and below if the Windows system service application requires ADLX functionality that is not available when ADLX runs in Session 0.

ADLX v1.5 and above

When ADLX v1.5 and above runs in a Windows system service application, the following functionality is available:

ADLX v1.4 and above

When ADLX v1.4 and above runs in a Windows system service application, the following functionality is available:

ADLX v1.3 and below

ADLX v1.3 and below cannot be used directly in a Windows system service application. However, ADLX functionality can be accessed in a system service application through a user mode process.

The functions are provided through a communication mechanism between the user mode process and the system service (such as shared memory).

To use ADLX v1.3 and below in a system service application,

  • Create a system service application.

  • For more information on how to create a system service application in C++, see ServiceCall C++ sample.

  • For more information on how to create a system service application in C, see ServiceCall C sample.

  • In the system service application, start a thread to complete the service work, such as ServiceWorkerThread.

  • On the ServiceWorkerThread, get the token of the current process to create a user process using CreateProcessAsUserW.

  • For more information on how to create a user process into a service application in C++, see UserProcess C++ sample.

  • For more information on how to create a user process into a service application in C, see UserProcess C sample.

  • In the user mode process, load ADLX and implement the desired functionality.

  • In the user mode process, implement a communication mechanism suitable for communicating with the system service (such as shared memory) and tie the ADLX data with the communication mechanism.

  • Run the user mode process and the service application.

For more information, see GPUServiceCall C++ samples and GPUServiceCall C samples.

API Reference

This page references: