Comprobación de la compatibilidad con recursos del Coordinador de actividades
En este ejemplo se muestra cómo las aplicaciones pueden usar IsActivityCoordinatorResourceSupported para detectar la compatibilidad con los recursos antes de crear una directiva. Puede usar IsActivityCoordinatorResourceSupported para comprobar si hay cualquier ACTIVITY_COORDINATOR_RESOURCE compatible en tiempo de ejecución.
Comprobación del ejemplo de compatibilidad con NPU
En el ejemplo siguiente se muestra cómo comprobar si hay compatibilidad con NPU mediante la nueva API de comprobación de funcionalidades para recursos. Esta API permite que las aplicaciones comprueben los tipos de recursos admitidos en tiempo de ejecución y devolverán true si el recurso de NPU es compatible con el sistema actual. En este ejemplo se crea una directiva de coordinador de actividades y se establece la condición ACTIVITY_COORDINATOR_CONDITION_GOOD de recurso de NPU en si se admite.
#include <Windows.h>
#include <ActivityCoordinator.h>
#include <wil/resource.h>
#include <apiquery2.h>
// Declare RAII wrappers for the Activity Coordinator policy and subscription.
// These behave like traditional smart pointers and will call their associated
// API cleanup functions when they go out of scope.
using unique_policy = wil::unique_any<
ACTIVITY_COORDINATOR_POLICY,
decltype(&DestroyActivityCoordinatorPolicy),
DestroyActivityCoordinatorPolicy>;
bool
CanUseNpuPolicy()
{
// Check that the Activity Coordinator feature check API is implemented
// before calling.
if (IsApiSetImplemented("ext-ms-win-resourcemanager-activitycoordinator-l1-1-1")) {
if (IsActivityCoordinatorResourceSupported(ACTIVITY_COORDINATOR_RESOURCE_NPU)) {
return true;
}
}
return false;
}
int
__cdecl
wmain()
{
unique_policy policy;
// Activity Coordinator support for NPUs does not indicate their actual
// presence on the system. Applications must still detect and target desired
// hardware using their API or framework of choice.
//
// When using system resources not supported by Activity Coordinator, it is
// recommended that policies always include USER_IDLE in the GOOD condition.
// This will help minimize the potential for interference with a user's
// foreground applications utilizing the same resource.
//
// The GOOD policy template covers this scenario in addition to other
// resources that most applications are likely to affect even when targeting
// dedicated hardware.
RETURN_IF_FAILED(CreateActivityCoordinatorPolicy(
ACTIVITY_COORDINATOR_POLICY_TEMPLATE_GOOD,
&policy));
if (CanUseNpuPolicy()) {
RETURN_IF_FAILED(SetActivityCoordinatorPolicyResourceCondition(
policy.get(),
ACTIVITY_COORDINATOR_RESOURCE_NPU,
ACTIVITY_COORDINATOR_CONDITION_GOOD));
}
// Proceed to use Activity Coordinator to run opportunistic work. See the
// example project in the documentation for further details.
return S_OK;
}