ID3D10Device::CreateTexture2D メソッド (d3d10.h)
2D テクスチャの配列を作成します ( 「Texture2D」を参照)。
構文
HRESULT CreateTexture2D(
[in] const D3D10_TEXTURE2D_DESC *pDesc,
[in] const D3D10_SUBRESOURCE_DATA *pInitialData,
[out] ID3D10Texture2D **ppTexture2D
);
パラメーター
[in] pDesc
型: const D3D10_TEXTURE2D_DESC*
2D テクスチャの説明へのポインター ( 「D3D10_TEXTURE2D_DESC」を参照)。 実行時に異なる互換性のある形式に解釈できる型なしのリソースを作成するには、テクスチャの説明で型なしの形式を指定します。 ミップマップ レベルを自動的に生成するには、ミップマップ レベルの数を 0 に設定します。
[in] pInitialData
型: const D3D10_SUBRESOURCE_DATA*
サブリソースの説明の配列へのポインター (D3D10_SUBRESOURCE_DATAを参照)。各サブリソースに対して 1 つ (テクスチャ配列インデックスで並べ替え、mip レベル)。 IMMUTABLE リソースの作成時に、アプリケーションで pInitialData に NULL を 指定できない場合があります ( 「D3D10_USAGE」を参照してください)。 リソースがマルチサンプリングの場合、マルチサンプリングされたリソースは作成時にデータで初期化できないため、pInitialData は NULL である必要があります。
[out] ppTexture2D
種類: ID3D10Texture2D**
作成されたテクスチャへのポインターのアドレス ( ID3D10Texture2D インターフェイスを参照)。 他の入力パラメーターを検証するには、このパラメーターを NULL に設定します (他の入力パラメーターが検証に合格した場合、メソッドはS_FALSEを返します)。
戻り値
型: HRESULT
メソッドが成功した場合、戻りコードはS_OK。 エラー コードの失敗については、「 Direct3D 10 リターン コード 」を参照してください。
注釈
CreateTexture2D は、1D テクスチャの配列を含む 2D テクスチャ リソースを作成します。 テクスチャの数は、テクスチャの説明で指定します。 リソース内のすべてのテクスチャは、ミップマップ レベルの形式、サイズ、および数が同じである必要があります。
すべてのリソースは、1 つ以上の サブリソースで構成されます。 テクスチャにデータを読み込むには、アプリケーションが最初に pInitialData によって指 D3D10_SUBRESOURCE_DATA 構造体の一部としてデータを提供するか、SDK によって提供される Texturing Functions のいずれかを使用できます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d10.h |
| Library | D3D10.lib |