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