SubscribeActivityCoordinatorPolicy 関数 (activitycoordinator.h)
ポリシーの構成に基づいて、指定されたコールバックに調整通知を配信するサブスクリプションを作成します。 通知時に、指定されたコールバックが指定されたコンテキストで実行されます。 現在の状態の通知は、別のスレッドですぐに配信され、この呼び出しが返される前に配信される場合があります。 サブスクライブ後にポリシーに加えられた変更は、サブスクリプションには影響しません。 1 つのポリシーを使用して、一意のポリシー構成を使用して多数のサブスクリプションを作成できます。 通知はシリアル化されます。
構文
HRESULT SubscribeActivityCoordinatorPolicy(
ACTIVITY_COORDINATOR_POLICY policy,
ACTIVITY_COORDINATOR_CALLBACK callback,
void *callbackContext,
ACTIVITY_COORDINATOR_SUBSCRIPTION *subscription
);
パラメーター
policy
ターゲット ポリシーへのハンドルを提供します。
callback
このサブスクリプションからのすべての調整通知に対して実行されるコールバックを提供します。
callbackContext
コールバック ルーチンに渡されるコンテキストを提供します。
subscription
作成されたサブスクリプション ハンドルを受け取る ACTIVITY_COORDINATOR_SUBSCRIPTION ハンドルへのポインターを提供します。
戻り値
HRESULT を返します。
注釈
メモ このコールバックでは、このサブスクリプションの今後のポリシー通知の配信がブロックされるため、このコールバックではアクティビティを実行しないでください。 このコールバックは、API からの RUN/STOP 通知に応答して、アクティビティの開始と停止を調整するために使用する必要があります。
メモUnsubscribeActivityCoordinatorPolicy がブロックされ、スレッド プールの枯渇に寄与する可能性があるため、このコールバックを長期間ブロックしないでください。
メモ このコールバックからの UnsubscribeActivityCoordinatorPolicy の呼び出しは失敗します。 サブスクライブ解除は、コールバックの外部で行う必要があります。
要件
| 要件 | 値 |
|---|---|
| Header | activitycoordinator.h |