FREAcquireByteArray()

AIR 3.0 以降

使用方法

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() を呼び出します。