FREAcquireByteArray()

用法

FREResult FREAcquireByteArray ( 
            FREObject                 object, 
            FREByteArray*                 byteArrayToSet 
);

参数

object

FREObject。此 FREObject 参数表示一个 ActionScript ByteArray 类对象。

byteArrayToSet

指向类型为 FREByteArray 的变量的指针。当本机 C 实现调用此方法时，运行时设置此结构的字段。请参阅 FREByteArray 。

返回

FREResult，可能的返回值包括（但不限于）下列值：

FRE_OK

函数已成功。设置了 FREByteArray 参数。ActionScript ByteArray 对象可供您操作。

FRE_ILLEGAL_STATE

扩展上下文已获取一个 ActionScript BitmapData 对象或 ByteArray 对象。在释放该 BitmapData 或 ByteArray 对象之前，上下文无法调用此方法。

FRE_INVALID_ARGUMENT

byteArrayToSet 参数为 NULL 。

FRE_INVALID_OBJECT

FREObject object 参数无效。

FRE_TYPE_MISMATCH

FREObject object 参数不表示 ActionScript ByteArray 类对象。

FRE_WRONG_THREAD

从运行时在其中具有对本机扩展函数的未决调用的线程以外的线程调用了方法。

说明

调用此函数可获取 ActionScript ByteArray 类对象的字节。成功调用此函数之后，在您调用 FREReleaseByteArray() 之前，将无法成功调用任何其他 C API 函数。存在这种限制的原因是其他调用执行的代码会使指向字节数组内容的指针无效。

调用了此函数后，便可操作 ByteArray 对象的字节。 byteArrayToSet 参数中提供了字节以及字节的数量。已完成位图处理后，调用 FREReleaseByteArray() 。