ID3D11Device::CreateTexture3D メソッド (d3d11.h)
1 つの 3D テクスチャを作成します。
構文
HRESULT CreateTexture3D(
[in] const D3D11_TEXTURE3D_DESC *pDesc,
[in, optional] const D3D11_SUBRESOURCE_DATA *pInitialData,
[out, optional] ID3D11Texture3D **ppTexture3D
);
パラメーター
[in] pDesc
型: const D3D11_TEXTURE3D_DESC*
3D テクスチャ リソースを記述する D3D11_TEXTURE3D_DESC 構造体へのポインター。 実行時に異なる互換性のある形式に解釈できる型なしのリソースを作成するには、テクスチャの説明で型なし形式を指定します。 ミップマップ レベルを自動的に生成するには、ミップマップ レベルの数を 0 に設定します。
[in, optional] pInitialData
型: const D3D11_SUBRESOURCE_DATA*
3D テクスチャ リソースのサブリソースを記述する D3D11_SUBRESOURCE_DATA 構造体の配列へのポインター。 IMMUTABLE リソースの作成時に、アプリケーションで pInitialData に NULL を指定することはできません (「D3D11_USAGE」を参照)。 リソースがマルチサンプリングの場合、マルチサンプリングリソースは作成時にデータで初期化できないため、 pInitialData は NULL である必要があります。
pInitialData に何も渡さない場合、リソースのメモリの初期コンテンツは未定義です。 この場合、リソースを読み取る前に、リソースコンテンツを何らかの方法で書き込む必要があります。
この配列のサイズは、pDesc が指すD3D11_TEXTURE3D_DESC構造体の MipLevels メンバーの値から決定できます。 3D ボリューム テクスチャの配列はサポートされていません。
この配列サイズの詳細については、「解説」を参照してください。
[out, optional] ppTexture3D
種類: ID3D11Texture3D**
作成されたテクスチャの ID3D11Texture3D インターフェイスへのポインターを受け取るバッファーへのポインター。 他の入力パラメーターを検証するには、このパラメーターを NULL に設定します (他の入力パラメーターが検証に合格した場合、メソッドはS_FALSEを返します)。
戻り値
種類: HRESULT
メソッドが成功した場合、戻りコードはS_OK。 失敗したエラー コードについては、「 Direct3D 11 リターン コード 」を参照してください。
注釈
CreateTexture3D は、3D テクスチャ リソースを作成します。このリソースには、多数の 3D サブリソースを含めることができます。 テクスチャの数は、テクスチャの説明で指定します。 リソース内のすべてのテクスチャの形式、サイズ、およびミップマップ レベルの数が同じである必要があります。
すべてのリソースは、1 つ以上のサブリソースで構成されます。 データをテクスチャに読み込むには、アプリケーションは、最初に pInitialData が指すD3D11_SUBRESOURCE_DATA構造体の配列としてデータを提供するか、D3DX11CreateTextureFromFile などの D3DX テクスチャ関数のいずれかを使用できます。
pInitialData の各要素は、特定の miplevel に対して定義されているすべてのスライスを提供します。 たとえば、完全なミップマップ チェーンを持つ 32 x 32 x 4 ボリューム テクスチャの場合、配列には次の 6 つの要素があります。
- pInitialData[0] = 32x32 と 4 つのスライス
- pInitialData[1] = 16x16 と 2 つのスライス
- pInitialData[2] = 8x8 と 1 スライス
- pInitialData[3] = 4x4 と 1 スライス
- pInitialData[4] = 2x2 と 1 スライス
- pInitialData[5] = 1x1 と 1 スライス
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d11.h |
| Library | D3D11.lib |