KMSTATUS kmGetTexture( pTexture, pSurfaceDesc )
PKMDWORD pTexture
PKMSURFACEDESC pSurfaceDesc
pTexture (出力)メインメモリ上の保存する領域を示すポインタ pSurfaceDesc (入力)テクスチャサーフェスディスクプリタへのポインタ
KMSTATUS_SUCCESS 読み出し成功 KMSTATUS_INVALID_ADDRESS 指定されたテクスチャサーフェスは確保されていない
指定したテクスチャメモリ上のテクスチャを、メインメモリ上に読み出します。出力されるのは、Kamuiテクスチャフォーマットのテクスチャピクセルデータ部分のみです。 ヘッダは付加されません。 また、pSurfaceDescにフレームバッファのSurfaceDescを指定すると、 指定されたフレームバッファの内容をメインメモリ上に読み出すことができます。
引数 pTextureは、テクスチャを保存するメインメモリ上の領域を示すポインタです。 32バイトアラインした32の倍数のバイト数を確保してください。
引数 pSurfaceDescは、保持しているテクスチャのサーフェスディスクプリタ KMSURFACEDESC 型の構造体へのポインタです。
メインメモリ側のテクスチャデータの先頭アドレスが32Byteアライメントしていて、 かつサイズが32Byteの倍数である場合、テクスチャメモリへの転送にDMAを使用し、 高速な転送が可能となります。