ホーム › Graphics.Direct3D11 › D3D11_MAPPED_SUBRESOURCE
D3D11_MAPPED_SUBRESOURCE
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pData | void* | 8/4 | +0 | +0 | データへのポインター。ID3D11DeviceContext::Map がこのポインターを提供する場合、ランタイムは次の機能レベルに応じて、ポインターが特定のアラインメントを持つことを保証します。
|
| RowPitch | DWORD | 4 | +8 | +4 | データの行ピッチ (幅、またはバイト単位の物理サイズ)。 |
| DepthPitch | DWORD | 4 | +12 | +8 | データの深度ピッチ (幅、またはバイト単位の物理サイズ)。 |
公式ドキュメント
サブリソースのデータへのアクセスを提供します。
解説(Remarks)
この構造体は ID3D11DeviceContext::Map の呼び出しで使用されます。
これらのメンバーの値から、参照できるデータの範囲が分かります。
- pData は行 0、深度スライス 0 を指します。
- RowPitch には、ある行から次の行へ移動するためにランタイムが pData に加算する値が格納されます。各行には複数のピクセルが含まれます。
- DepthPitch には、ある深度スライスから次の深度スライスへ移動するためにランタイムが pData に加算する値が格納されます。各深度スライスには複数の行が含まれます。
- Buffer と Texture1D の場合、ランタイムは RowPitch と DepthPitch に 0 以外の値を割り当てます。たとえば、Buffer に 8 バイトが含まれる場合、ランタイムは RowPitch と DepthPitch に 8 以上の値を割り当てます。
- Texture2D の場合、そのフィールドが使用されないとしても、ランタイムは DepthPitch に 0 以外の値を割り当てます。
注意 行間や深度間にパディングが存在する可能性があるため、ランタイムは RowPitch と DepthPitch に想定より大きな値を割り当てることがあります。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// D3D11_MAPPED_SUBRESOURCE (x64 16 / x86 12 バイト)
typedef struct D3D11_MAPPED_SUBRESOURCE {
void* pData;
DWORD RowPitch;
DWORD DepthPitch;
} D3D11_MAPPED_SUBRESOURCE;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D11_MAPPED_SUBRESOURCE
{
public IntPtr pData;
public uint RowPitch;
public uint DepthPitch;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D11_MAPPED_SUBRESOURCE
Public pData As IntPtr
Public RowPitch As UInteger
Public DepthPitch As UInteger
End Structureimport ctypes
from ctypes import wintypes
class D3D11_MAPPED_SUBRESOURCE(ctypes.Structure):
_fields_ = [
("pData", ctypes.c_void_p),
("RowPitch", wintypes.DWORD),
("DepthPitch", wintypes.DWORD),
]#[repr(C)]
pub struct D3D11_MAPPED_SUBRESOURCE {
pub pData: *mut core::ffi::c_void,
pub RowPitch: u32,
pub DepthPitch: u32,
}import "golang.org/x/sys/windows"
type D3D11_MAPPED_SUBRESOURCE struct {
pData uintptr
RowPitch uint32
DepthPitch uint32
}type
D3D11_MAPPED_SUBRESOURCE = record
pData: Pointer;
RowPitch: DWORD;
DepthPitch: DWORD;
end;const D3D11_MAPPED_SUBRESOURCE = extern struct {
pData: ?*anyopaque,
RowPitch: u32,
DepthPitch: u32,
};type
D3D11_MAPPED_SUBRESOURCE {.bycopy.} = object
pData: pointer
RowPitch: uint32
DepthPitch: uint32struct D3D11_MAPPED_SUBRESOURCE
{
void* pData;
uint RowPitch;
uint DepthPitch;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; D3D11_MAPPED_SUBRESOURCE サイズ: 12 バイト(x86)
dim st, 3 ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; pData : void* (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; RowPitch : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; DepthPitch : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D11_MAPPED_SUBRESOURCE サイズ: 16 バイト(x64)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; pData : void* (+0, 8byte) qpoke st,0,値 / qpeek(st,0) ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; RowPitch : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; DepthPitch : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3D11_MAPPED_SUBRESOURCE
#field intptr pData
#field int RowPitch
#field int DepthPitch
#endstruct
stdim st, D3D11_MAPPED_SUBRESOURCE ; NSTRUCT 変数を確保
st->RowPitch = 100
mes "RowPitch=" + st->RowPitch