> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UnregisterLampArrayCallback

> 使用回呼權杖取消註冊先前註冊的 LampArrayCallback，並在指定的逾時時間內等候進行中的回呼完成。

# UnregisterLampArrayCallback

取消註冊 LampArray 回呼函式。

## 語法

```cpp theme={null}
bool UnregisterLampArrayCallback(
    LampArrayCallbackToken callbackToken,
    uint64_t timeoutInMicroseconds);
```

### 參數

*callbackToken*\
類型：LampArrayCallbackToken

要取消註冊之回呼函式的權杖。此權杖是在函式最初透過 [RegisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraycallback.md) 註冊時產生。

*timeoutInMicroseconds*\
類型：uint64\_t

等候回呼完成以便取消註冊的時間長度。

### 傳回值

類型：bool

如果回呼已成功取消註冊，則為 True。False 表示回呼權杖值無效，或在等候進行中的回呼傳回時逾時。傳回 false 時仍會確保不會分派新的回呼。已在進行中的回呼仍會執行。

## 備註

在 UnregisterLampArrayCallback 函式成功傳回之前，釋放與回呼相關聯的任何資源 (例如卸載裝載回呼函式的 DLL) 並不安全。因此，無法從其註冊的回呼函式內取消註冊回呼，嘗試這麼做將會終止處理序。

下列程式碼是註冊和取消註冊 LampArray 回呼的範例：

```cpp theme={null}
void MyLampArrayCallback(
    _In_opt_ void* context,
    bool isAttached,
    _In_ ILampArray* lampArray)
{
    if (isAttached)
    {
        // Application-specific code to handle LampArray connection
    }
    else
    {
        // Application-specific code to handle LampArray disconnection
    }
}

void MonitorLampArrays(
    _In_ volatile bool & cancelMonitoring) noexcept
{
    LampArrayCallbackToken token = LAMPARRAY_INVALID_CALLBACK_TOKEN_VALUE;
    if (SUCCEEDED(RegisterLampArrayCallback(
        MyLampArrayCallback,
        nullptr /* context */,
        &token)))
    {
        while (!cancelMonitoring)
        {
            Sleep(100);
        }

        UnregisterLampArrayCallback(token, 5000);
    }
}
```

## 需求

**標頭：** LampArray.h

**程式庫：** xgameplatform.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[照明 API 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/gc-lighting-toc.md)\
[照明基本概念](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-basics.md)\
[LampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/lamparraycallback.md)\
[RegisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraycallback.md)


## Related topics

- [LampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/lamparraycallback.md)
- [LampArray API 成員](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/lamparray_members.md)
- [LampArrayStatusCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/lamparraystatuscallback.md)
- [RegisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraycallback.md)
- [RegisterLampArrayStatusCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)