ID3D11Device3::CreateTexture2D1 メソッド (d3d11_3.h)

  • [アーティクル]

2D テクスチャを作成します。

構文

HRESULT CreateTexture2D1(
  [in]            const D3D11_TEXTURE2D_DESC1  *pDesc1,
  [in, optional]  const D3D11_SUBRESOURCE_DATA *pInitialData,
  [out, optional] ID3D11Texture2D1             **ppTexture2D
);

パラメーター

[in] pDesc1

型: const D3D11_TEXTURE2D_DESC1*

2D テクスチャ リソースを記述する D3D11_TEXTURE2D_DESC1 構造体へのポインター。 実行時に異なる互換性のある形式に解釈できる型なしのリソースを作成するには、テクスチャの説明で型なしの形式を指定します。 ミップマップ レベルを自動的に生成するには、ミップマップ レベルの数を 0 に設定します。

[in, optional] pInitialData

型: const D3D11_SUBRESOURCE_DATA*

2D テクスチャ リソースのサブリソースを記述する D3D11_SUBRESOURCE_DATA 構造体の配列へのポインター。 IMMUTABLE リソースの作成時に、アプリケーションで pInitialData に NULL を指定することはできません (「D3D11_USAGE」を参照してください)。 リソースがマルチサンプリングの場合、マルチサンプリングされたリソースは作成時にデータで初期化できないため、 pInitialData は NULL である必要があります。

pInitialData に何も渡さない場合、リソースのメモリの初期コンテンツは未定義です。 この場合は、リソースを読み取る前に、他の方法でリソース コンテンツを書き込む必要があります。

次の計算を使用して、pDesc1 が指すD3D11_TEXTURE2D_DESC1構造体の MipLevels メンバーと ArraySize メンバーの値から、この配列のサイズを決定できます。

MipLevels * ArraySize

この配列サイズの詳細については、「解説」を参照してください。

[out, optional] ppTexture2D

種類: ID3D11Texture2D1**

作成されたテクスチャの ID3D11Texture2D1 インターフェイスへのポインターを受け取るメモリ ブロックへのポインター。 他の入力パラメーターを検証するには、このパラメーターを NULL に設定します (他の入力パラメーターが検証に合格した場合、メソッドは S_FALSE を返します)。

戻り値

型: HRESULT

メソッドが成功した場合、戻りコードは S_OK。 エラー コードの失敗については、「 Direct3D 11 リターン コード 」を参照してください。

注釈

CreateTexture2D1 は、2D テクスチャ リソースを作成します。このリソースには、多数の 2D サブリソースを含めることができます。 サブリソースの数は、テクスチャの説明で指定します。 リソース内のすべてのテクスチャは、ミップマップ レベルの形式、サイズ、および数が同じである必要があります。

すべてのリソースは、1 つ以上のサブリソースで構成されます。 データをテクスチャに読み込むには、最初に pInitialData が指すD3D11_SUBRESOURCE_DATA構造体の配列としてデータを指定するか、D3DX11CreateTextureFromFile などの D3DX テクスチャ関数のいずれかを使用できます。

完全ミップマップ チェーンを持つ 32 x 32 テクスチャの場合、 pInitialData 配列には次の 6 つの要素があります。

  • pInitialData[0] = 32x32
  • pInitialData[1] = 16x16
  • pInitialData[2] = 8x8
  • pInitialData[3] = 4x4
  • pInitialData[4] = 2x2
  • pInitialData[5] = 1x1

要件

要件 値
サポートされている最小のクライアント Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー d3d11_3.h
Library D3D11.lib

こちらもご覧ください

ID3D11Device3