Udostępnij przez

Sprawdzanie wsparcia zasobów dla koordynatora działań

W tym przykładzie pokazano, jak aplikacje mogą używać IsActivityCoordinatorResourceSupported do wykrywania obsługi zasobów przed utworzeniem polityki. Możesz użyć IsActivityCoordinatorResourceSupported, aby podczas wykonywania sprawdzić, czy jest obsługiwany ACTIVITY_COORDINATOR_RESOURCE.

Sprawdź przykład obsługi NPU

W poniższym przykładzie pokazano, jak sprawdzić obsługę urządzenia NPU przy użyciu nowego interfejsu API sprawdzania możliwości zasobów. Ten interfejs API umożliwia aplikacjom sprawdzanie obsługiwanych typów zasobów w czasie wykonywania i zwraca true, jeśli zasób NPU jest obsługiwany w bieżącym systemie. Ten przykład tworzy politykę Koordynatora Działań i ustawia warunek zasobu NPU na ACTIVITY_COORDINATOR_CONDITION_GOOD, jeśli jest obsługiwany.

#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;
}

Zobacz też

  • Last updated on