활동 코디네이터 리소스 지원 확인
이 예제에서는 앱이 IsActivityCoordinatorResourceSupported를 사용하여 정책을 만들기 전에 리소스에 대한 지원을 검색하는 방법을 보여 줍니다. 런타임에 IsActivityCoordinatorResourceSupported 지원되는 ACTIVITY_COORDINATOR_RESOURCE 확인할 수 있습니다.
NPU 지원 예제 확인
다음 예제에서는 리소스에 대한 새 기능 확인 API를 사용하여 NPU 지원을 확인하는 방법을 보여 줍니다. 이 API를 사용하면 앱이 런타임에 지원되는 리소스 종류를 확인할 수 있으며 현재 시스템에서 NPU 리소스가 지원되는지 여부를 반환 true 합니다. 다음은 활동 코디네이터 정책을 만들고 NPU 리소스 조건이 지원되는지를 ACTIVITY_COORDINATOR_CONDITION_GOOD 설정하는 예제입니다.
#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;
}