错误代码参考 - Amazon Kinesis Video Streams
PutFrame 回调返回的错误和状态码-平台独立代码 (PIC) PutFrame 回调返回的错误和状态码-C 制作人库
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

错误代码参考

此部分包含 创建者库 的错误和状态代码信息。

有关常见问题解决方法的信息，请参阅 对 Kinesis Video Streams 进行故障排除

PutFrame 回调返回的错误和状态码-平台独立代码 (PIC)

以下各节包含平台独立代码 (PIC) 中PutFrame操作的回调返回的错误和状态信息。

客户端库返回的错误和状态码

下表包含 Kinesis Video Client Streams 库中的方法返回的错误和状态信息。

代码 消息 描述 推荐操作
0x52000001 STATUS_MAX_STREAM_COUNT 已达到最大流数。 在 DeviceInfo 中指定更大的最大流数，该数量是在制作人 SDK 限制中指定的。
0x52000002 STATUS_MIN_STREAM_COUNT 最小流数错误。 在中指定大于零的流的最大数量DeviceInfo。
0x52000003 STATUS_INVALID_DEVICE_NAME_LENGTH 设备名称长度无效。 请参阅中指定的以字符为单位的最大设备名称长度制作人 SDK 限制。
0x52000004 STATUS_INVALID_DEVICE_INFO_VERSION DeviceInfo 结构版本无效。 指定正确的当前结构版本。
0x52000005 STATUS_MAX_TAG_COUNT 已达到最大标记数。 请参阅中指定的当前最大标签数制作人 SDK 限制。
0x52000006 STATUS_DEVICE_FINGERPRINT_LENGTH
0x52000007 STATUS_INVALID_CALLBACKS_VERSION Callbacks 结构版本无效。 指定正确的当前结构版本。
0x52000008 STATUS_INVALID_STREAM_INFO_VERSION StreamInfo 结构版本无效。 指定正确的当前结构版本。
0x52000009 STATUS_INVALID_STREAM_NAME_LENGTH 流名称长度无效。 请参阅中指定的以字符为单位的最大直播名称长度制作人 SDK 限制。
0x5200000a STATUS_INVALID_STORAGE_SIZE 指定的存储大小无效。 存储大小 (字节) 必须在制作人 SDK 限制中指定的限制内。
0x5200000b STATUS_INVALID_ROOT_DIRECTORY_LENGTH 根目录字符串长度无效。 请参阅中指定的最大根目录路径长度制作人 SDK 限制。
0x5200000c STATUS_INVALID_SPILL_RATIO 溢出率无效。 以 0—100 之间的百分比表示溢出率。
0x5200000d STATUS_INVALID_STORAGE_INFO_VERSION StorageInfo 结构版本无效。 指定正确的当前结构版本。
0x5200000e STATUS_INVALID_STREAM_STATE 流处于不允许执行当前操作的状态。 最常见的是，当 SDK 无法达到执行请求的操作所需的状态时，就会发生此错误。例如，如果 GetStreamingEndpoint API 调用失败，并且客户端应用程序忽略该失败并继续将帧放入流中，则会出现该错误。
0x5200000f STATUS_SERVICE_CALL_CALLBACKS_MISSING 对于某些必需函数，Callbacks 结构具有缺少的函数入口点。 验证强制回调是否已在客户端应用程序中实现。此错误仅暴露于平台独立代码 (PIC) 客户端。C++ 和其他更高级别的包装程序满足这些调用的要求。
0x52000010 STATUS_SERVICE_CALL_NOT_AUTHORIZED_ERROR 未授权。 验证安全令牌、证书、安全令牌集成和到期。验证令牌是否具有正确的关联权限。对于 Kinesis Video Streams 示例应用程序，请验证环境变量设置是否正确。
0x52000011 STATUS_DESCRIBE_STREAM_CALL_FAILED DescribeStream API 失败。 在 DescribeStream API 重试失败后，将返回该错误。PIC 客户端在停止重试后返回此错误。
0x52000012 STATUS_INVALID_DESCRIBE_STREAM_RESPONSE DescribeStreamResponse 结构无效。 传递给 DescribeStreamResultEvent 的结构为 Null 或包含无效的项目，例如，Null Amazon 资源名称 (ARN)。
0x52000013 STATUS_STREAM_IS_BEING_DELETED_ERROR 正在删除流。 API 失败是由正在删除的流造成的。确认在使用该流时，没有其他进程正在尝试删除该流。
0x52000014 STATUS_SERVICE_CALL_INVALID_ARG_ERROR 为服务调用指定的参数无效。 当服务调用参数无效或 SDK 遇到无法解释的错误时，后端会返回此错误。
0x52000015 STATUS_SERVICE_CALL_DEVICE_NOT_FOUND_ERROR 找不到设备。 确认设备在使用过程中未被删除。
0x52000016 STATUS_SERVICE_CALL_DEVICE_NOT_PROVISIONED_ERROR 未预置设备。 验证设备是否已配置。
0x52000017 STATUS_SERVICE_CALL_RESOURCE_NOT_FOUND_ERROR 找不到从服务中返回的常规资源。 在服务找不到资源 (例如，流) 时，将会出现该错误。它可能在不同上下文中具有不同的含义，但可能的原因是在创建流之前使用 API。使用 SDK 确认直播已先创建。
0x52000018 STATUS_INVALID_AUTH_LEN 身份验证信息长度无效。 请参阅制作人 SDK 限制中指定的当前值。
0x52000019 STATUS_CREATE_STREAM_CALL_FAILED CreateStream API 调用失败。 有关操作失败原因的更详细信息，请参阅错误字符串。
0x5200002a STATUS_GET_STREAMING_TOKEN_CALL_FAILED GetStreamingToken 调用失败。 有关操作失败原因的更详细信息，请参阅错误字符串。
0x5200002b STATUS_GET_STREAMING_ENDPOINT_CALL_FAILED GetStreamingEndpoint API 调用失败。 有关操作失败原因的更详细信息，请参阅错误字符串。
0x5200002c STATUS_INVALID_URI_LEN 从 GetStreamingEndpoint API 中返回的 URI 字符串长度无效。 请参阅制作人 SDK 限制中指定的当前最大值。
0x5200002d STATUS_PUT_STREAM_CALL_FAILED PutMedia API 调用失败。 有关操作失败原因的更详细信息，请参阅错误字符串。
0x5200002e STATUS_STORE_OUT_OF_MEMORY 内容存储内存不足。 内容存储是在流之间共享的，应具有足够的容量以存储所有流的最大持续时间内的内容 + ~20% (考虑碎片整理)。请切勿使存储溢出。请选择与累计存储大小和容许的延迟对应的每个流的最大持续时间值。我们建议在框架从内容视图窗口中掉出来时将其丢掉，而不是直接放置（内容存储内存压力）。这是因为丢帧会启动直播压力通知回调。然后，应用程序可以调整上游媒体组件 (如编码器) 以降低比特率，删除帧或执行相应的操作。
0x5200002f STATUS_NO_MORE_DATA_AVAILABLE 流当前没有更多的可用数据。 在媒体管道生成帧的速度比网络线程使用发送到服务的帧的速度慢时，这可能是一个有效的结果。更高级别的客户端（例如 C++、Java 或 Android）不会看到此警告，因为它是在内部处理的。
0x52000030 STATUS_INVALID_TAG_VERSION Tag 结构版本无效。 指定正确的当前结构版本。
0x52000031 STATUS_SERVICE_CALL_UNKNOWN_ERROR 从网络堆栈中返回未知或常规错误。 有关更详细信息，请参阅日志。
0x52000032 STATUS_SERVICE_CALL_RESOURCE_IN_USE_ERROR 正在使用资源。 这是从服务中返回的。有关更多信息，请参阅 Kinesis Video Streams API 参考。
0x52000033 STATUS_SERVICE_CALL_CLIENT_LIMIT_ERROR 客户端限制。 这是从服务中返回的。有关更多信息，请参阅 Kinesis Video Streams API 参考。
0x52000034 STATUS_SERVICE_CALL_DEVICE_LIMIT_ERROR 设备限制。 这是从服务中返回的。有关更多信息，请参阅 Kinesis Video Streams API 参考。
0x52000035 STATUS_SERVICE_CALL_STREAM_LIMIT_ERROR 流限制。 这是从服务中返回的。有关更多信息，请参阅 Kinesis Video Streams API 参考。
0x52000036 STATUS_SERVICE_CALL_RESOURCE_DELETED_ERROR 已删除或正在删除资源。 这是从服务中返回的。有关更多信息，请参阅 Kinesis Video Streams API 参考。
0x52000037 STATUS_SERVICE_CALL_TIMEOUT_ERROR 服务调用超时。 调用特定服务 API 导致超时。验证您的网络连接是否有效。PIC 将自动重试该操作。
0x52000038 STATUS_STREAM_READY_CALLBACK_FAILED 流就绪通知。 该通知从 PIC 发送到客户端，表示已创建异步流。
0x52000039 STATUS_DEVICE_TAGS_COUNT_NON_ZERO_TAGS_NULL 指定的标记无效。 标签数不为零，但标签为空。验证标签是否已指定或计数为零。
0x5200003a STATUS_INVALID_STREAM_DESCRIPTION_VERSION StreamDescription 结构版本无效。 指定正确的当前结构版本。
0x5200003b STATUS_INVALID_TAG_NAME_LEN 标记名称长度无效。 请参阅制作人 SDK 限制中指定的标记名称限制。
0x5200003c STATUS_INVALID_TAG_VALUE_LEN 标记值长度无效。 请参阅制作人 SDK 限制中指定的标记值限制。
0x5200003d STATUS_TAG_STREAM_CALL_FAILED TagResource API 失败。 TagResource API 调用失败。检查有效的网络连接。有关该失败的更多信息，请参阅日志。
0x5200003e STATUS_INVALID_CUSTOM_DATA 调用 PIC API 的自定义数据无效。 在 PIC API 调用中指定的自定义数据无效。仅在直接使用 PIC 的客户端中可能会发生这种情况。
0x5200003f STATUS_INVALID_CREATE_STREAM_RESPONSE CreateStreamResponse 结构无效。 结构或其成员字段无效 (即，ARN 为 Null 或大于制作人 SDK 限制中指定的值)。
0x52000040 STATUS_CLIENT_AUTH_CALL_FAILED 客户端身份验证失败。 多次重试后，PIC 未能获得正确的身份验证信息（AccessKeyId或SecretAccessKey）。检查身份验证集成。示例应用程序使用环境变量将凭证信息传入到 C++ 创建者库。
0x52000041 STATUS_GET_CLIENT_TOKEN_CALL_FAILED 获取安全令牌调用失败。 仅在直接使用 PIC 的客户端中可能会发生这种情况。在重试一定次数后，调用失败并出现该错误。
0x52000042 STATUS_CLIENT_PROVISION_CALL_FAILED 预置错误。 未实现配置。
0x52000043 STATUS_CREATE_CLIENT_CALL_FAILED 无法创建创建者客户端。 在客户端创建失败时，在重试一定次数后，PIC 返回一个常规错误。
0x52000044 STATUS_CLIENT_READY_CALLBACK_FAILED 无法将创建者客户端置于就绪状态。 这是在 PIC 无法变为就绪状态时 PIC 状态机返回的。有关根本原因的更多信息，请参阅日志。
0x52000045 STATUS_TAG_CLIENT_CALL_FAILED 创建者客户端的 TagResource 失败。 创建者客户端的 TagResource API 调用失败。有关根本原因的更多信息，请参阅日志。
0x52000046 STATUS_INVALID_CREATE_DEVICE_RESPONSE 设备/创建者创建失败。 更高级别的软件开发工具包（例如 C++ 或 Java）尚未实现设备或制作者创建 API。直接使用 PIC 的客户端可以使用结果通知指示失败。
0x52000047 STATUS_ACK_TIMESTAMP_NOT_IN_VIEW_WINDOW 在视图中不显示收到的 ACK 的时间戳。 如果与收到的 ACK 对应的帧没有位于内容视图窗口中，则会出现该错误。通常，如果 ACK 传输速度较慢，则会发生这种情况。可以将其解释为警告，并指示下行链路速度较慢。
0x52000048 STATUS_INVALID_FRAGMENT_ACK_VERSION FragmentAck 结构版本无效。 指定正确的当前 FragmentAck 结构版本。
0x52000049 STATUS_INVALID_TOKEN_EXPIRATION 安全令牌到期日期无效。 安全令牌到期后的绝对时间戳应大于当前时间戳，并带有宽限期。有关宽限期的限制，请参阅制作人 SDK 限制。
0x5200004a STATUS_END_OF_STREAM 流结束 (EOS) 指示符。 在 GetStreamData API 调用中，指示当前上传处理会话已结束。如果会话结束或出现错误，或者会话令牌已过期并且正在轮换会话，则会发生这种情况。
0x5200004b STATUS_DUPLICATE_STREAM_NAME 重复的流名称。 多个流不能具有相同的流名称。为流选择唯一的名称。
0x5200004c STATUS_INVALID_RETENTION_PERIOD 保留期无效。 在 StreamInfo 结构中指定的保留期无效。有关有效的保留期值范围的信息，请参阅制作人 SDK 限制。
0x5200004d STATUS_INVALID_ACK_KEY_START 无效 FragmentAck。 无法解析片段 ACK 字符串。键开始指示符无效。片段 ACK 字符串可能已损坏。它可以自行更正，并且可以将该错误视为警告。
0x5200004e STATUS_INVALID_ACK_DUPLICATE_KEY_NAME 无效 FragmentAck。 无法解析片段 ACK 字符串。多个键具有相同的名称。片段 ACK 字符串可能已损坏。它可以自行更正，并且可以将该错误视为警告。
0x5200004f STATUS_INVALID_ACK_INVALID_VALUE_START 无效 FragmentAck。 无法解析片段 ACK 字符串，因为键值开始指示符无效。片段 ACK 字符串可能已损坏。它可以自行更正，并且可以将该错误视为警告。
0x52000050 STATUS_INVALID_ACK_INVALID_VALUE_END 无效 FragmentAck。 无法解析片段 ACK 字符串，因为键值结束指示符无效。片段 ACK 字符串可能已损坏。它可以自行更正，并且可以将该错误视为警告。
0x52000051 STATUS_INVALID_PARSED_ACK_TYPE 无效 FragmentAck。 无法解析片段 ACK 字符串，因为指定的 ACK 类型无效。
0x52000052 STATUS_STREAM_HAS_BEEN_STOPPED 已停止流。 已停止流，但仍在将帧放入流中。
0x52000053 STATUS_INVALID_STREAM_METRICS_VERSION StreamMetrics 结构版本无效。 指定正确的当前 StreamMetrics 结构版本。
0x52000054 STATUS_INVALID_CLIENT_METRICS_VERSION ClientMetrics 结构版本无效。 指定正确的当前 ClientMetrics 结构版本。
0x52000055 STATUS_INVALID_CLIENT_READY_STATE 创建者初始化无法达到就绪状态。 在创建者客户端初始化期间，无法达到就绪状态。有关更多信息，请参阅日志。
0x52000056 STATUS_STATE_MACHINE_STATE_NOT_FOUND 内部状态机错误。 不是公开可见的错误。
0x52000057 STATUS_INVALID_FRAGMENT_ACK_TYPE 在 FragmentAck 结构中指定的 ACK 类型无效。 FragmentAck 结构应包含公共标头中定义的 ACK 类型。
0x52000058 STATUS_INVALID_STREAM_READY_STATE 内部状态机转换错误。 不是公开可见的错误。
0x52000059 STATUS_CLIENT_FREED_BEFORE_STREAM 在释放创建者后释放流对象。 尝试在释放创建者对象后释放流对象。仅在直接使用 PIC 的客户端中可能会发生这种情况。
0x5200005a STATUS_ALLOCATION_SIZE_SMALLER_THAN_REQUESTED 内部存储错误。 内部错误，表示来自内容存储的实际分配大小小于已打包的帧和片段的大小。
0x5200005b STATUS_VIEW_ITEM_SIZE_GREATER_THAN_ALLOCATION 内部存储错误。 内容视图中存储的分配大小大于内容存储中的分配大小。
0x5200005c STATUS_ACK_ERR_STREAM_READ_ERROR 流读取错误 ACK。 ACK 从后端返回的错误，表示流读取或解析错误。在后端无法检索流时，通常会发生这种情况。自动重新流式传输通常可以纠正该错误。
0x5200005d STATUS_ACK_ERR_FRAGMENT_SIZE_REACHED 已达到最大片段大小。 在制作人 SDK 限制中定义了最大片段大小 (字节)。该错误表示具有非常大的帧，或者没有用于创建可管理大小的片段的关键帧。检查编码器设置并验证关键帧是否正确生成。对于具有较高密度的流，请将编码器配置为生成具有较短持续时间的片段以管理最大大小。
0x5200005e STATUS_ACK_ERR_FRAGMENT_DURATION_REACHED 已达到最大片段持续时间。 在制作人 SDK 限制中定义了最大片段持续时间。该错误表示每秒具有非常少的帧，或者没有用于创建可管理持续时间的片段的关键帧。检查编码器设置并验证关键帧是否按固定间隔正确生成。
0x5200005f STATUS_ACK_ERR_CONNECTION_DURATION_REACHED 已达到最大连接持续时间。 Kinesis Video Streams 强制执行中指定的最大连接持续时间。制作人 SDK 限制在达到最大值之前，Producer SDK 会自动轮换直播或令牌。使用 SDK 的客户不应收到此错误。
0x52000060 STATUS_ACK_ERR_FRAGMENT_TIMECODE_NOT_MONOTONIC 时间码不是单调递增的。 Producer SDK 强制使用时间戳，因此使用 SDK 的客户端不应收到此错误。
0x52000061 STATUS_ACK_ERR_MULTI_TRACK_MKV 在 MKV 中具有多个音轨。 Producer SDK 强制使用单轨流，因此使用 SDK 的客户端不应收到此错误。
0x52000062 STATUS_ACK_ERR_INVALID_MKV_DATA MKV 数据无效。 后端 MKV 解析器在解析流时遇到错误。如果直播在过渡期间损坏，使用 SDK 的客户端可能会遇到此错误。如果缓冲压力迫使 SDK 丢掉部分传输的尾帧，也会发生这种情况。在后一种情况下，我们建议您要么降低 FPS 和分辨率，提高压缩率，要么（如果有 “爆发” 的网络）允许更大的内容存储和缓冲持续时间以适应临时压力。
0x52000063 STATUS_ACK_ERR_INVALID_PRODUCER_TIMESTAMP 创建者时间戳无效。 如果创建者时钟大幅漂移到将来的时间，服务将返回该错误 ACK。更高级别的 SDK (例如，Java 或 C++) 使用某种版本的系统时钟以满足从 PIC 中回调当前时间的要求。验证系统时钟设置是否正确。直接使用 PIC 的客户端应验证其回调函数是否返回了正确的时间戳。
0x52000064 STATUS_ACK_ERR_STREAM_NOT_ACTIVE 非活动流。 在流未处于“活动”状态时，对后端 API 进行了调用。如果客户端创建流并立即继续将帧推入流中，则会发生这种情况。SDK 通过状态机和恢复机制处理这种情况。
0x52000065 STATUS_ACK_ERR_KMS_KEY_ACCESS_DENIED Amazon KMS 访问被拒绝错误。 在账户没有指定密钥的访问权限时返回。
0x52000066 STATUS_ACK_ERR_KMS_KEY_DISABLED Amazon KMS密钥已禁用。 已禁用指定的密钥。
0x52000067 STATUS_ACK_ERR_KMS_KEY_VALIDATION_ERROR Amazon KMS 密钥验证错误。 常规验证错误。有关更多信息，请参阅 Amazon Key Management Service API 参考。
0x52000068 STATUS_ACK_ERR_KMS_KEY_UNAVAILABLE Amazon KMS key不可用。 密钥不可用。有关更多信息，请参阅 Amazon Key Management Service API 参考。
0x52000069 STATUS_ACK_ERR_KMS_KEY_INVALID_USAGE KMS 密钥的使用无效。 未配置为在此上下文中使用。Amazon KMS key有关更多信息，请参阅 Amazon Key Management Service API 参考。
0x5200006a STATUS_ACK_ERR_KMS_KEY_INVALID_STATE Amazon KMS 状态无效。 有关更多信息，请参阅 Amazon Key Management Service API 参考。
0x5200006b STATUS_ACK_ERR_KMS_KEY_NOT_FOUND 找不到 KMS 密钥。 找不到密钥。有关更多信息，请参阅 Amazon Key Management Service API 参考。
0x5200006c STATUS_ACK_ERR_STREAM_DELETED 已删除或正在删除流。 正在由另一个应用程序或通过 Amazon Web Services Management Console删除流。
0x5200006d STATUS_ACK_ERR_ACK_INTERNAL_ERROR 内部错误。 常规服务内部错误。
0x5200006e STATUS_ACK_ERR_FRAGMENT_ARCHIVAL_ERROR 片段存档错误。 在服务无法持久保留片段并为其编制索引时返回。虽然非常少见，但可能会出于各种原发生这种情况。默认情况下，SDK 再次尝试发送片段。
0x5200006f STATUS_ACK_ERR_UNKNOWN_ACK_ERROR 未知错误。 服务返回未知错误。
0x52000070 STATUS_MISSING_ERR_ACK_ID 缺少 ACK 信息。 ACK 解析器已完成解析，但缺少 FragmentAck 信息。
0x52000071 STATUS_INVALID_ACK_SEGMENT_LEN ACK 段长度无效。 为 ACK 解析器指定的 ACK 段字符串具有无效的长度。有关更多信息，请参阅制作人 SDK 限制：
0x52000074 STATUS_MAX_FRAGMENT_METADATA_COUNT 已向片段中添加最大数目的元数据项目。 Kinesis 视频流最多可以向片段添加 10 个元数据项，方法是向片段添加非永久项目，也可以向元数据队列中添加永久项目。有关更多信息，请参阅在 Kinesis Video Streams 中使用流式传输元数据：
0x52000075 STATUS_ACK_ERR_FRAGMENT_METADATA_LIMIT_REACHED 已达到限制（最大元数据计数、元数据名称长度或元数据值长度）。 创建者开发工具包限制元数据项目的数量和大小。除非更改了 Producer SDK 代码中的限制，否则不会发生此错误。有关更多信息，请参阅在 Kinesis Video Streams 中使用流式传输元数据：
0x52000076 STATUS_BLOCKING_PUT_INTERRUPTED_STREAM_TERMINATED 未实现。
0x52000077 STATUS_INVALID_METADATA_NAME 元数据名称无效。 元数据名称不能以字符串 “Amazon” 开头。如果发生此错误，则不会将元数据项添加到片段或元数据队列中。有关更多信息，请参阅在 Kinesis Video Streams 中使用流式传输元数据：
0x52000078 STATUS_END_OF_FRAGMENT_FRAME_INVALID_STATE 片段帧的结尾处于无效状态。 片段的结尾不应以碎片流的形式 non-key-frame 发送。
0x52000079 STATUS_TRACK_INFO_MISSING 缺少轨道信息。 曲目编号必须大于零且与曲目 ID 相匹配。
0x5200007a STATUS_MAX_TRACK_COUNT_EXCEEDED 超出最大轨道数。 每个直播最多可以有三首曲目。
0x5200007b STATUS_OFFLINE_MODE_WITH_ZERO_RETENTION 离线流式处理模式保留时间设置为零。 离线直播模式的保留时间不应设置为零。
0x5200007c STATUS_ACK_ERR_TRACK_NUMBER_MISMATCH 错误 ACK 的轨道编号不匹配。
0x5200007d STATUS_ACK_ERR_FRAMES_MISSING_FOR_TRACK 轨道缺少帧。
0x5200007e STATUS_ACK_ERR_MORE_THAN_ALLOWED_TRACKS_FOUND 超出允许的最大轨道数。
0x5200007f STATUS_UPLOAD_HANDLE_ABORTED 上传处理已中止。
0x52000080 STATUS_INVALID_CERT_PATH_LENGTH 证书路径长度无效。
0x52000081 STATUS_DUPLICATE_TRACK_ID_FOUND 找到重复的轨道 ID。
0x52000082 STATUS_INVALID_CLIENT_INFO_VERSION
0x52000083 STATUS_INVALID_CLIENT_ID_STRING_LENGTH
0x52000084 STATUS_SETTING_KEY_FRAME_FLAG_WHILE_USING_EOFR
0x52000085 STATUS_MAX_FRAME_TIMESTAMP_DELTA_BETWEEN_TRACKS_EXCEEDED
0x52000086 STATUS_STREAM_SHUTTING_DOWN
0x52000087 STATUS_CLIENT_SHUTTING_DOWN
0x52000088 STATUS_PUTMEDIA_LAST_PERSIST_ACK_NOT_RECEIVED
0x52000089 STATUS_NON_ALIGNED_HEAP_WITH_IN_CONTENT_STORE_ALLOCATORS
0x5200008a STATUS_MULTIPLE_CONSECUTIVE_EOFR
0x5200008b STATUS_DUPLICATE_STREAM_EVENT_TYPE
0x5200008c STATUS_STREAM_NOT_STARTED
0x5200008d STATUS_INVALID_IMAGE_PREFIX_LENGTH
0x5200008e STATUS_INVALID_IMAGE_METADATA_KEY_LENGTH
0x5200008f STATUS_INVALID_IMAGE_METADATA_VALUE_LENGTH

持续时间库返回的错误和状态码

下表包含Duration库中方法返回的错误和状态信息。

代码 消息
0xFFFFFFFFFFFFFFFF INVALID_DURATION_VALUE

公共库返回的错误和状态码

下表包含Common库中方法返回的错误和状态信息。

注意

对于很多 API，这些错误和状态信息代码是相同的。

代码 消息 描述
0x00000001 STATUS_NULL_ARG 为必需参数传递了 NULL。
0x00000002 STATUS_INVALID_ARG 为参数指定的值无效。
0x00000003 STATUS_INVALID_ARG_LEN 指定的参数长度无效。
0x00000004 STATUS_NOT_ENOUGH_MEMORY 无法分配足够的内存。
0x00000005 STATUS_BUFFER_TOO_SMALL 指定的缓冲区大小太小。
0x00000006 STATUS_UNEXPECTED_EOF 到达意外的文件末尾。
0x00000007 STATUS_FORMAT_ERROR 遇到无效的格式。
0x00000008 STATUS_INVALID_HANDLE_ERROR 句柄值无效。
0x00000009 STATUS_OPEN_FILE_FAILED 无法打开文件。
0x0000000a STATUS_READ_FILE_FAILED 无法从文件中读取。
0x0000000b STATUS_WRITE_TO_FILE_FAILED 无法写入到文件中。
0x0000000c STATUS_INTERNAL_ERROR 通常不会出现的内部错误，可能表示 SDK 或服务 API 错误。
0x0000000d STATUS_INVALID_OPERATION 具有无效的操作，或者不允许执行该操作。
0x0000000e STATUS_NOT_IMPLEMENTED 未实现该功能。
0x0000000f STATUS_OPERATION_TIMED_OUT 操作已超时。
0x00000010 STATUS_NOT_FOUND 找不到所需的资源。
0x00000011 STATUS_CREATE_THREAD_FAILED 创建话题失败。
0x00000012 STATUS_THREAD_NOT_ENOUGH_RESOURCES 资源不足，无法创建另一个线程，或者遇到了系统对线程数量施加的限制。
0x00000013 STATUS_THREAD_INVALID_ARG 指定的话题属性无效，或者其他话题已在等待加入此话题。
0x00000014 STATUS_THREAD_PERMISSIONS 没有权限设置线程属性中指定的调度策略和参数。
0x00000015 STATUS_THREAD_DEADLOCKED 检测到死锁或者加入的线程指定了调用线程。
0x00000016 STATUS_THREAD_DOES_NOT_EXIST 找不到具有指定话题 ID 的话题。
0x00000017 STATUS_JOIN_THREAD_FAILED 线程联接操作返回未知或一般错误。
0x00000018 STATUS_WAIT_FAILED 已超过等待条件变量的最长时间。
0x00000019 STATUS_CANCEL_THREAD_FAILED 线程取消操作返回未知或一般错误。
0x0000001a STATUS_THREAD_IS_NOT_JOINABLE 在不可连接的线程上请求线程加入操作。
0x0000001b STATUS_DETACH_THREAD_FAILED 线程分离操作返回未知或一般错误。
0x0000001c STATUS_THREAD_ATTR_INIT_FAILED 无法初始化线程属性对象。
0x0000001d STATUS_THREAD_ATTR_SET_STACK_SIZE_FAILED 未能为线程属性对象设置堆栈大小。
0x0000001e STATUS_MEMORY_NOT_FREED 仅在测试中使用。表示未释放所有请求的内存。
0x10000015 STATUS_INVALID_ALLOCATION_SIZE
0x10000016 STATUS_HEAP_REALLOC_ERROR
0x10000017 STATUS_HEAP_FILE_HEAP_FILE_CORRUPT

堆库返回的错误和状态码

下表包含Heap库中方法返回的错误和状态信息。

代码 消息 描述
0x01000001 STATUS_HEAP_FLAGS_ERROR 指定的标记组合无效。
0x01000002 STATUS_HEAP_NOT_INITIALIZED 在初始化堆之前尝试执行一个操作。
0x01000003 STATUS_HEAP_CORRUPTED 堆已损坏或已覆盖保护频段 (在调试模式下)。客户端代码中的缓冲区溢出可能导致堆损坏。
0x01000004 STATUS_HEAP_VRAM_LIB_MISSING VRAM（视频 RAM）用户或内核模式库无法加载或缺失。检查底层平台是否支持 VRAM 分配。
0x01000005 STATUS_HEAP_VRAM_LIB_REOPEN 无法打开 VRAM 库。
0x01000006 STATUS_HEAP_VRAM_INIT_FUNC_SYMBOL 无法加载 INIT 函数导出。
0x01000007 STATUS_HEAP_VRAM_ALLOC_FUNC_SYMBOL 无法加载 ALLOC 函数导出。
0x01000008 STATUS_HEAP_VRAM_FREE_FUNC_SYMBOL 无法加载 FREE 函数导出。
0x01000009 STATUS_HEAP_VRAM_LOCK_FUNC_SYMBOL 无法加载 LOCK 函数导出。
0x0100000a STATUS_HEAP_VRAM_UNLOCK_FUNC_SYMBOL 无法加载 UNLOCK 函数导出。
0x0100000b STATUS_HEAP_VRAM_UNINIT_FUNC_SYMBOL 无法加载 UNINIT 函数导出。
0x0100000c STATUS_HEAP_VRAM_GETMAX_FUNC_SYMBOL 无法加载 GETMAX 函数导出。
0x0100000d STATUS_HEAP_DIRECT_MEM_INIT 无法初始化混合堆中的主堆池。
0x0100000e STATUS_HEAP_VRAM_INIT_FAILED VRAM 动态初始化失败。
0x0100000f STATUS_HEAP_LIBRARY_FREE_FAILED 无法取消分配并释放 VRAM 库。
0x01000010 STATUS_HEAP_VRAM_ALLOC_FAILED VRAM 分配失败。
0x01000011 STATUS_HEAP_VRAM_FREE_FAILED VRAM 释放失败。
0x01000012 STATUS_HEAP_VRAM_MAP_FAILED VRAM 映射失败。
0x01000013 STATUS_HEAP_VRAM_UNMAP_FAILED VRAM 取消映射失败。
0x01000014 STATUS_HEAP_VRAM_UNINIT_FAILED VRAM 取消初始化失败。

MKVGen 库返回的错误和状态码

下表包含MKVGen库中方法返回的错误和状态信息。

代码 消息 描述/建议的操作
0x32000001 STATUS_MKV_INVALID_FRAME_DATA Frame 数据结构的成员无效。确保时长、大小和帧数据有效且在中指定的限制范围内制作人 SDK 限制。
0x32000002 STATUS_MKV_INVALID_FRAME_TIMESTAMP 帧时间戳无效。计算的 PTS（演示时间戳）和 DTS（解码时间戳）大于或等于片段开始帧的时间戳。这表示潜在的媒体管道重新启动或编码器稳定性问题。有关故障排除信息，请参阅错误：“Failed to submit frame to Kinesis Video client”(无法将帧提交到 Kinesis 视频客户端)。
0x32000003 STATUS_MKV_INVALID_CLUSTER_DURATION 指定的片段持续时间无效。有关更多信息，请参阅制作人 SDK 限制：
0x32000004 STATUS_MKV_INVALID_CONTENT_TYPE_LENGTH 内容类型字符串长度无效。有关更多信息，请参阅制作人 SDK 限制：
0x32000005 STATUS_MKV_NUMBER_TOO_BIG 尝试编码的数字太大，无法使用 EBML (可扩展二进制元语言) 格式表示。不会向 SDK 客户端显示该错误。
0x32000006 STATUS_MKV_INVALID_CODEC_ID_LENGTH 编解码器 ID 字符串长度无效。有关更多信息，请参阅制作人 SDK 限制：
0x32000007 STATUS_MKV_INVALID_TRACK_NAME_LENGTH 音轨名称字符串长度无效。有关更多信息，请参阅制作人 SDK 限制：
0x32000008 STATUS_MKV_INVALID_CODEC_PRIVATE_LENGTH 编解码器私有数据长度无效。有关更多信息，请参阅制作人 SDK 限制：
0x32000009 STATUS_MKV_CODEC_PRIVATE_NULL 编解码器私有数据 (CPD) 为空，而 CPD 大小大于零。
0x3200000a STATUS_MKV_INVALID_TIMECODE_SCALE 时间码标度值无效。有关更多信息，请参阅制作人 SDK 限制：
0x3200000b STATUS_MKV_MAX_FRAME_TIMECODE 帧时间码大于最大值。有关更多信息，请参阅制作人 SDK 限制：
0x3200000c STATUS_MKV_LARGE_FRAME_TIMECODE 已达到最大帧时间码。MKV 格式使用有符号 16 位表示帧相对于集群开头的时间码。如果无法表示帧时间码，则会生成错误。该错误表示选择的时间码标度不正确或集群持续时间太长，因此，表示帧时间码将导致有符号 16 位空间溢出。
0x3200000d STATUS_MKV_INVALID_ANNEXB_NALU_IN_FRAME_DATA 遇到无效的 Annex-B 启动代码。例如，指定了 Annex-B 适配标记，并且代码遇到包含超过三个零的无效开始序列。有效的 Annex-B 格式应具有“模拟防护”序列，以便对字节流中包含三个或更多零的序列进行转义。有关更多信息，请参阅 MPEG 规范。有关 Android 上的此错误的信息，请参阅 Android 上的 STATUS_MKV_INVALID_ANNEXB_NALU_IN_FRAME_DATA (0x3200000d) 错误。
0x3200000e STATUS_MKV_INVALID_AVCC_NALU_IN_FRAME_DATA 指定自适应 AVCC 标志时，AVCC NALU 打包无效。验证字节流是否为有效的 AVCC 格式。有关更多信息，请参阅 MPEG 规范。
0x3200000f STATUS_MKV_BOTH_ANNEXB_AND_AVCC_SPECIFIED 同时指定了改编 AVCC 和 Annex-B 的 NALU。指定其中的一个 NAL，或者不指定任何 NAL。
0x32000010 STATUS_MKV_INVALID_ANNEXB_NALU_IN_CPD 在指定了适配 Annex-B 标记时，CPD 的 Annex-B 格式无效。验证 CPD 格式是否有效 Annex-B。如果不是，则移除 CPD Annex-B 适应标志。
0x32000011 STATUS_MKV_PTS_DTS_ARE_NOT_SAME Kinesis Video Streams 强制片段起始帧的 PTS（演示时间戳）和 DTS（解码时间戳）相同。这些是片段开头的关键帧。
0x32000012 STATUS_MKV_INVALID_H264_H265_CPD 无法解析 H264/H265 编解码器私有数据。
0x32000013 STATUS_MKV_INVALID_H264_H265_SPS_WIDTH 无法从编解码器私有数据中提取宽度。
0x32000014 STATUS_MKV_INVALID_H264_H265_SPS_HEIGHT 无法从编解码器私有数据中提取高度。
0x32000015 STATUS_MKV_INVALID_H264_H265_SPS_NALU H264/H265 SPS NALU 无效。
0x32000016 STATUS_MKV_INVALID_BIH_CPD 编解码器私有数据中的位图信息标头格式无效。
0x32000017 STATUS_MKV_INVALID_HEVC_NALU_COUNT 高效高级音频编码 (HEVC) 网络抽象层单元 (NALU) 计数无效。
0x32000018 STATUS_MKV_INVALID_HEVC_FORMAT HEVC 格式无效。
0x32000019 STATUS_MKV_HEVC_SPS_NALU_MISSING 序列参数集 (SPS) 中缺少 HEVC NALU。
0x3200001a STATUS_MKV_INVALID_HEVC_SPS_NALU_SIZE HEVC SPS NALU 大小无效。
0x3200001b STATUS_MKV_INVALID_HEVC_SPS_CHROMA_FORMAT_IDC 色度格式 IDC 无效。
0x3200001c STATUS_MKV_INVALID_HEVC_SPS_RESERVED HEVC 保留 SPS 无效。
0x3200001d STATUS_MKV_MIN_ANNEX_B_CPD_SIZE AnnexBb 编解码器私有测试版的最小值大小。对于 H264，该值必须等于或大于 11。对于 H265，该值必须等于或大于 15。
0x3200001e STATUS_MKV_ANNEXB_CPD_MISSING_NALUS Annex-B NALU 中缺少编解码器专用数据。
0x3200001f STATUS_MKV_INVALID_ANNEXB_CPD_NALUS Annex-B NALU 中的编解码器封闭测试版无效。
0x32000020 STATUS_MKV_INVALID_TAG_NAME_LENGTH 标记名称长度无效。有效值大于 0 且小于 128。
0x32000021 STATUS_MKV_INVALID_TAG_VALUE_LENGTH 标记值长度无效。有效值大于零且小于 256。
0x32000022 STATUS_MKV_INVALID_GENERATOR_STATE_TAGS 生成器状态标签无效。
0x32000023 STATUS_MKV_INVALID_AAC_CPD_SAMPLING_FREQUENCY_INDEX AAC 编解码器专用数据采样频率索引无效。
0x32000024 STATUS_MKV_INVALID_AAC_CPD_CHANNEL_CONFIG AAC 编解码器专用数据通道配置无效。
0x32000025 STATUS_MKV_INVALID_AAC_CPD AAC 编解码器专用数据无效。
0x32000026 STATUS_MKV_TRACK_INFO_NOT_FOUND 找不到轨道信息。
0x32000027 STATUS_MKV_INVALID_SEGMENT_UUID 片段 UUID 无效。
0x32000028 STATUS_MKV_INVALID_TRACK_UID 轨道 UID 无效。
0x32000029 STATUS_MKV_INVALID_CLIENT_ID_LENGTH
0x3200002a STATUS_MKV_INVALID_AMS_ACM_CPD
0x3200002b STATUS_MKV_MISSING_SPS_FROM_H264_CPD
0x3200002c STATUS_MKV_MISSING_PPS_FROM_H264_CPD
0x3200002d STATUS_MKV_INVALID_PARENT_TYPE

Trace 库返回的错误和状态码

下表包含Trace库中方法返回的错误和状态信息。

代码 消息
0x10100001 STATUS_MIN_PROFILER_BUFFER

Utils 库返回的错误和状态码

下表包含Utils库中方法返回的错误和状态信息。

代码 消息
0x40000001 STATUS_INVALID_BASE64_ENCODE
0x40000002 STATUS_INVALID_BASE
0x40000003 STATUS_INVALID_DIGIT
0x40000004 STATUS_INT_OVERFLOW
0x40000005 STATUS_EMPTY_STRING
0x40000006 STATUS_DIRECTORY_OPEN_FAILED
0x40000007 STATUS_PATH_TOO_LONG
0x40000008 STATUS_UNKNOWN_DIR_ENTRY_TYPE
0x40000009 STATUS_REMOVE_DIRECTORY_FAILED
0x4000000a STATUS_REMOVE_FILE_FAILED
0x4000000b STATUS_REMOVE_LINK_FAILED
0x4000000c STATUS_DIRECTORY_ACCESS_DENIED
0x4000000d STATUS_DIRECTORY_MISSING_PATH
0x4000000e STATUS_DIRECTORY_ENTRY_STAT_ERROR
0x4000000f STATUS_STRFTIME_FALIED
0x40000010 STATUS_MAX_TIMESTAMP_FORMAT_STR_LEN_EXCEEDED
0x40000011 STATUS_UTIL_MAX_TAG_COUNT
0x40000012 STATUS_UTIL_INVALID_TAG_VERSION
0x40000013 STATUS_UTIL_TAGS_COUNT_NON_ZERO_TAGS_NULL
0x40000014 STATUS_UTIL_INVALID_TAG_NAME_LEN
0x40000015 STATUS_UTIL_INVALID_TAG_VALUE_LEN
0x4000002a STATUS_EXPONENTIAL_BACKOFF_INVALID_STATE
0x4000002b STATUS_EXPONENTIAL_BACKOFF_RETRIES_EXHAUSTED
0x4000002c STATUS_THREADPOOL_MAX_COUNT
0x4000002d STATUS_THREADPOOL_INTERNAL_ERROR
0x40100001 STATUS_HASH_KEY_NOT_PRESENT
0x40100002 STATUS_HASH_KEY_ALREADY_PRESENT
0x40100003 STATUS_HASH_ENTRY_ITERATION_ABORT
0x41000001 STATUS_BIT_READER_OUT_OF_RANGE
0x41000002 STATUS_BIT_READER_INVALID_SIZE
0x41100001 STATUS_TIMER_QUEUE_STOP_SCHEDULING
0x41100002 STATUS_INVALID_TIMER_COUNT_VALUE
0x41100003 STATUS_INVALID_TIMER_PERIOD_VALUE
0x41100004 STATUS_MAX_TIMER_COUNT_REACHED
0x41100005 STATUS_TIMER_QUEUE_SHUTDOWN
0x41200001 STATUS_SEMAPHORE_OPERATION_AFTER_SHUTDOWN
0x41200002 STATUS_SEMAPHORE_ACQUIRE_WHEN_LOCKED
0x41300001 STATUS_FILE_LOGGER_INDEX_FILE_INVALID_SIZE

View 库返回的错误和状态码

下表包含View库中方法返回的错误和状态信息。

代码 消息 描述
0x30000001 STATUS_MIN_CONTENT_VIEW_ITEMS 指定的内容视图项目数无效。有关更多信息，请参阅制作人 SDK 限制：
0x30000002 STATUS_INVALID_CONTENT_VIEW_DURATION 指定的内容视图持续时间无效。有关更多信息，请参阅制作人 SDK 限制：
0x30000003 STATUS_CONTENT_VIEW_NO_MORE_ITEMS 尝试获取的位置超过标头。
0x30000004 STATUS_CONTENT_VIEW_INVALID_INDEX 指定的索引无效。
0x30000005 STATUS_CONTENT_VIEW_INVALID_TIMESTAMP 具有无效的时间戳，或者时间戳发生重叠。帧解码时间戳应大于或等于前一帧的时间戳，再加上前一帧的持续时间：。`DTS(n) >= DTS(n-1) + Duration(n-1)`该错误通常表示“不稳定”编码器。编码器生成一组突发编码帧，并且其时间戳小于帧内的持续时间。或者，流配置为使用 SDK 时间戳，并且发送帧的速度比帧持续时间快。为了帮助解决编码器中的一些“抖动”问题，请在 StreamInfo.StreamCaps 结构中指定较小的帧持续时间。例如，如果视频流为 25 FPS，则每帧的持续时间为 40 毫秒。但是，为了处理编码器的 “抖动”，我们建议您使用该帧持续时间的一半（20 毫秒）。某些流要求更精确地控制错误检测时间。
0x30000006 STATUS_INVALID_CONTENT_VIEW_LENGTH 指定的内容视图项目数据长度无效。

PutFrame 回调返回的错误和状态码-C 制作人库

以下部分包含 C producer 库中PutFrame操作的回调返回的错误和状态信息。

代码 消息 描述 推荐操作
0x15000001 STATUS_STOP_CALLBACK_CHAIN 回调链已停止。
0x15000002 STATUS_MAX_CALLBACK_CHAIN 已达到最大回调链数。
0x15000003 STATUS_INVALID_PLATFORM_CALLBACKS_VERSION PlatformCallbacks 结构版本无效。 指定正确的当前结构版本。
0x15000004 STATUS_INVALID_PRODUCER_CALLBACKS_VERSION ProducerCallbacks 结构版本无效。 指定正确的当前结构版本。
0x15000005 STATUS_INVALID_STREAM_CALLBACKS_VERSION StreamCallbacks 结构版本无效。 指定正确的当前结构版本。
0x15000006 STATUS_INVALID_AUTH_CALLBACKS_VERSION AuthCallbacks 结构版本无效。 指定正确的当前结构版本。
0x15000007 STATUS_INVALID_API_CALLBACKS_VERSION ApiCallbacks 结构版本无效。 指定正确的当前结构版本。
0x15000008 STATUS_INVALID_AWS_CREDENTIALS_VERSION AwsCredentials 结构版本无效。 指定正确的当前结构版本。
0x15000009 STATUS_MAX_REQUEST_HEADER_COUNT 已达到最大请求标头数。
0x1500000a STATUS_MAX_REQUEST_HEADER_NAME_LEN 已达到最大请求标头名称长度。
0x1500000b STATUS_MAX_REQUEST_HEADER_VALUE_LEN 已达到最大请求标头值长度。
0x1500000c STATUS_INVALID_API_CALL_RETURN_JSON API 调用的返回 JSON 无效。
0x1500000d STATUS_CURL_INIT_FAILED Curl 初始化失败。
0x1500000e STATUS_CURL_LIBRARY_INIT_FAILED Curl lib 初始化失败。
0x1500000f STATUS_INVALID_DESCRIBE_STREAM_RETURN_JSON 的返回 JSON 无效 DescribeStream。
0x15000010 STATUS_HMAC_GENERATION_ERROR HMAC 生成错误。
0x15000011 STATUS_IOT_FAILED 物联网授权失败。
0x15000012 STATUS_MAX_ROLE_ALIAS_LEN_EXCEEDED 已达到最大角色别名长度。 请指定较短的别名长度。
0x15000013 STATUS_MAX_USER_AGENT_NAME_POSTFIX_LEN_EXCEEDED 已达到最大代理名称后缀长度。
0x15000014 STATUS_MAX_CUSTOM_USER_AGENT_LEN_EXCEEDED 已达到最大客户用户代理长度。
0x15000015 STATUS_INVALID_USER_AGENT_LENGTH 无效的用户代理长度。
0x15000016 STATUS_INVALID_ENDPOINT_CACHING_PERIOD 无效的终端节点缓存期。 指定小于 24 小时的缓存期。
0x15000017 STATUS_IOT_EXPIRATION_OCCURS_IN_PAST IoT 过期时间戳发生在过去。
0x15000018 STATUS_IOT_EXPIRATION_PARSING_FAILED 物联网过期解析失败。
0x15000019 STATUS_DUPLICATE_PRODUCER_CALLBACK_FREE_FUNC
0x1500001a STATUS_DUPLICATE_STREAM_CALLBACK_FREE_FUNC
0x1500001b STATUS_DUPLICATE_AUTH_CALLBACK_FREE_FUNC
0x1500001c STATUS_DUPLICATE_API_CALLBACK_FREE_FUNC
0x1500001d STATUS_FILE_LOGGER_INDEX_FILE_TOO_LARGE
0x1500001e STATUS_MAX_IOT_THING_NAME_LENGTH
0x1500001f STATUS_IOT_CREATE_LWS_CONTEXT_FAILED
0x15000020 STATUS_INVALID_CA_CERT_PATH
0x15000022 STATUS_FILE_CREDENTIAL_PROVIDER_OPEN_FILE_FAILED
0x15000023 STATUS_FILE_CREDENTIAL_PROVIDER_INVALID_FILE_LENGTH
0x15000024 STATUS_FILE_CREDENTIAL_PROVIDER_INVALID_FILE_FORMAT
0x15000026 STATUS_STREAM_BEING_SHUTDOWN
0x15000027 STATUS_CLIENT_BEING_SHUTDOWN
0x15000028 STATUS_CONTINUOUS_RETRY_RESET_FAILED
0x16000001 STATUS_CURL_PERFORM_FAILED
0x16000002 STATUS_IOT_INVALID_RESPONSE_LENGTH
0x16000003 STATUS_IOT_NULL_AWS_CREDS
0x16000004 STATUS_IOT_INVALID_URI_LEN
0x16000005 STATUS_TIMESTAMP_STRING_UNRECOGNIZED_FORMAT