ID3D11Device1

デバイスインターフェイスは仮想アダプターを表し、リソースの作成に使用します。ID3D11Device1 は ID3D11Device のメソッドに加えて、新しいメソッドを追加します。

コマンドリストを再生できるイミディエイトコンテキストを取得します。(ID3D11Device1.GetImmediateContext1)

GetImmediateContext1 は、イミディエイトコンテキストを表す ID3D11DeviceContext1 オブジェクトを返します。このイミディエイトコンテキストを使用すると、デバイスに直ちに送信したいレンダリングを実行できます。ほとんどのアプリケーションでは、イミディエイトコンテキストがシーンの描画に使用する中心的なオブジェクトになります。

GetImmediateContext1 は、イミディエイトコンテキストの参照カウントを 1 つ増やします。そのため、メモリリークを避けるために、使用を終えたら返されたインターフェイスポインターに対して Release を呼び出してください。

コマンドリストを記録できる遅延コンテキストを作成します。(ID3D11Device1.CreateDeferredContext1)

成功した場合は S_OK を返します。それ以外の場合は、次のいずれかを返します。

• グラフィックスアダプターがコンピューターから物理的に取り外された場合、またはグラフィックスアダプターのドライバーがアップグレードされた場合は DXGI_ERROR_DEVICE_REMOVED を返します。 このエラーが発生した場合は、デバイスを破棄して再作成してください。
• 現在のコンテキストから CreateDeferredContext1 メソッドを呼び出せない場合は DXGI_ERROR_INVALID_CALL を返します。 たとえば、D3D11_CREATE_DEVICE_SINGLETHREADED 値を指定してデバイスを作成した場合、CreateDeferredContext1 は DXGI_ERROR_INVALID_CALL を返します。
• ContextFlags パラメーターが無効な場合は E_INVALIDARG を返します。
• アプリケーションが利用可能なメモリを使い果たした場合は E_OUTOFMEMORY を返します。

遅延コンテキストはスレッドセーフなコンテキストであり、メインのレンダリングスレッド以外のスレッドでグラフィックスコマンドを記録するために使用できます。 遅延コンテキストを使用すると、ID3D11CommandList インターフェイスにカプセル化されたコマンドリストにグラフィックスコマンドを記録できます。 シーンの項目をすべて記録した後、最終的なレンダリングのためにそれらをメインのレンダリングスレッドに送信できます。 この方法により、複数のスレッドで並行してレンダリング処理を実行でき、マルチコア CPU 環境ではパフォーマンスの向上が期待できます。

遅延コンテキストは複数作成できます。

Windows Phone 8: この API はサポートされています。

出力マージャーステージのブレンドステートをカプセル化し、論理演算の構成を可能にするブレンドステートオブジェクトを作成します。

ブレンドステートオブジェクトを作成するためのメモリが不足している場合、このメソッドは E_OUTOFMEMORY を返します。
その他の戻り値については、Direct3D 11 の戻り値コード を参照してください。

論理演算 (ピクセルシェーダーの出力とレンダーターゲットの内容との間でビットごとの論理演算を有効にするもの。D3D11_RENDER_TARGET_BLEND_DESC1 を参照) は、特定の機能レベルでのみ使用できます。サポートされているかどうかを確認するには、D3D11_FEATURE_D3D11_OPTIONS を指定して CheckFeatureSupport を呼び出し、D3D11_FEATURE_DATA_D3D11_OPTIONS のブール値フィールド OutputMergerLogicOp を確認してください。

アプリケーションは、一意なブレンドステートオブジェクトを最大 4096 個作成できます。オブジェクトを作成するたびに、ランタイムは同じステートを持つオブジェクトが既に存在するかどうかを確認します。そのようなオブジェクトが既に存在する場合、ランタイムは重複するオブジェクトを作成せず、既存のインスタンスへのポインターを返します。

ラスタライザーステージの動作を指定し、UAV レンダリングまたはラスタライズ時にサンプル数を強制するラスタライザーステートオブジェクトを作成します。(ID3D11Device1.CreateRasterizerState1)

ラスタライザーステートオブジェクトを作成するためのメモリが不足している場合、このメソッドは E_OUTOFMEMORY を返します。その他の戻り値については、Direct3D 11 の戻り値コード を参照してください。

アプリケーションは、一意なラスタライザーステートオブジェクトを最大 4096 個作成できます。オブジェクトを作成するたびに、ランタイムは同じステートを持つオブジェクトが既に存在するかどうかを確認します。そのようなオブジェクトが既に存在する場合、ランタイムは重複するオブジェクトを作成せず、既存のインスタンスへのポインターを返します。

Microsoft Direct3D のすべてのステートと一部の Direct3D の動作を保持するコンテキストステートオブジェクトを作成します。

型: HRESULT

このメソッドは、Direct3D 11 の戻り値コード のいずれかを返します。

エミュレートするインターフェイスの REFIID 値は、__uuidof 演算子を使用して取得する GUID です。たとえば __uuidof(ID3D11Device) は、Microsoft Direct3D 11 デバイスのインターフェイスの GUID を取得します。

コンテキストステートオブジェクトを有効にするには、ID3D11DeviceContext1::SwapDeviceContextState メソッドを呼び出します。 コンテキストステートオブジェクトが有効な間は、そのコンテキストステートオブジェクトの機能レベルと互換インターフェイスの両方に関連付けられたデバイスの動作が、次に SwapDeviceContextState を呼び出すまで Direct3D デバイス上で有効になります。

コンテキストステートオブジェクトが有効な間、ランタイムはデバイスインターフェイスおよびコンテキストインターフェイスの一部のメソッドを無効にします。たとえば、__uuidof(ID3D11Device) で作成したコンテキストステートオブジェクトでは、ランタイムは Microsoft Direct3D 10 のデバイスインターフェイスのほとんどを無効にします。__uuidof(ID3D10Device1) または __uuidof(ID3D10Device) で作成したコンテキストステートオブジェクトでは、ランタイムは ID3D11DeviceContext のメソッドのほとんどを無効にします。 この動作により、いずれかのエミュレートインターフェイスの利用者が、もう一方のエミュレートインターフェイスでは表現できないデバイスステートを設定できないことが保証されます。この制限によって、ID3D10Device1 エミュレートインターフェイスがパイプラインの状態全体を正確に反映し、本来のインターフェイス定義に反する動作をしないことが保証されます。

たとえば、Direct3D 10 の同等の関数ではなく D3D11CreateDevice または D3D11CreateDeviceAndSwapChain でデバイスを作成し、ID3D11DeviceContext インターフェイスを通じてテセレーションステージを有効にした場合を考えます。 このとき Direct3D 11 のコンテキストが有効であるため、QueryInterface で Direct3D 10 インターフェイスを最初に取得した時点では、そのインターフェイスは無効です。つまり、Direct3D 11 デバイスから取得した Direct3D 10 インターフェイスを、そのまま関数に渡すことはできません。まず SwapDeviceContextState を呼び出して、Direct3D 10 互換のコンテキストステートオブジェクトを有効にする必要があります。

次の表は、エミュレートインターフェイスごとに有効になるメソッドと無効になるメソッドを示しています。

次の表は、指定したコンテキストステートオブジェクトが有効なときにランタイムが無効にするイミディエイトコンテキストのメソッドを示しています。

次の表は、指定したコンテキストステートオブジェクトが有効なときでもランタイムが無効にしないイミディエイトコンテキストのメソッドを示しています。

次の表は、イミディエイトコンテキストのメソッドではないためランタイムが無効にしない ID3D10Device インターフェイスのメソッドを示しています。

Windows Phone 8: この API はサポートされています。

別のデバイスで作成され、ハンドルによって参照される共有リソースへのアクセス権をデバイスに与えます。

このメソッドは、Direct3D 11 の戻り値コード のいずれかを返します。また、リソースへのアクセス許可が有効でない場合は E_ACCESSDENIED を返します。

Platform Update for Windows 7: Platform Update for Windows 7 をインストールした Windows 7 または Windows Server 2008 R2 では、NTHANDLE が使用されるため、OpenSharedResource1 は E_NOTIMPL で失敗します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

OpenSharedResource1 の動作は ID3D11Device::OpenSharedResource メソッドの動作に似ています。リソースにアクセスするために OpenSharedResource1 を呼び出すたびに、新しいリソースオブジェクトが作成されます。 つまり、OpenSharedResource1 を 2 回呼び出して同じリソースハンドルを hResource に渡すと、異なる IUnknown ポインターを持つ 2 つのリソースオブジェクトが得られます。

2 つのデバイス間でリソースを共有するには

1. D3D11_RESOURCE_MISC_SHARED_NTHANDLE フラグを設定して、リソースを共有として作成し、NT ハンドルを使用することを指定します。
2. __uuidof() マクロを使用して、リソースのインターフェイスの REFIID (GUID) を取得します。たとえば __uuidof(ID3D11Texture2D) は、2D テクスチャのインターフェイスの GUID を取得します。
3. リソースに対して IDXGIResource1 インターフェイスをクエリします。
4. IDXGIResource1::CreateSharedHandle メソッドを呼び出して、リソースの一意なハンドルを取得します。

例

HANDLE handle = GetSharedHandleFromOtherProcess();
ID3D11Device1* pDevice;
ID3D11Texture2D* pTexture2D;

pDevice->OpenSharedResource1(
          handle, 
          __uuidof(ID3D11Texture2D), 
          (void**)&pTexture2D);

別のデバイスで作成され、名前によって参照される共有リソースへのアクセス権をデバイスに与えます。

このメソッドは、Direct3D 11 の戻り値コード のいずれかを返します。また、リソースへのアクセス許可が有効でない場合は E_ACCESSDENIED を返します。

Platform Update for Windows 7: Platform Update for Windows 7 をインストールした Windows 7 または Windows Server 2008 R2 では、NTHANDLE が使用されるため、OpenSharedResourceByName は E_NOTIMPL で失敗します。Platform Update for Windows 7 の詳細については、Platform Update for Windows 7 を参照してください。

OpenSharedResourceByName の動作は ID3D11Device1::OpenSharedResource1 メソッドの動作に似ています。リソースにアクセスするために OpenSharedResourceByName を呼び出すたびに、新しいリソースオブジェクトが作成されます。 つまり、OpenSharedResourceByName を 2 回呼び出して同じリソース名を lpName に渡すと、異なる IUnknown ポインターを持つ 2 つのリソースオブジェクトが得られます。

2 つのデバイス間でリソースを共有するには

1. D3D11_RESOURCE_MISC_SHARED_NTHANDLE フラグを設定して、リソースを共有として作成し、NT ハンドルを使用することを指定します。
2. __uuidof() マクロを使用して、リソースのインターフェイスの REFIID (GUID) を取得します。たとえば __uuidof(ID3D11Texture2D) は、2D テクスチャのインターフェイスの GUID を取得します。
3. リソースに対して IDXGIResource1 インターフェイスをクエリします。
4. IDXGIResource1::CreateSharedHandle メソッドを呼び出して、リソースの一意なハンドルを取得します。その後 OpenSharedResourceByName を呼び出して名前でリソースにアクセスする場合は、この IDXGIResource1::CreateSharedHandle の呼び出しでリソースの名前を渡す必要があります。

例

ID3D11Device1* pDevice;
ID3D11Texture2D* pTexture2D;

pDevice->OpenSharedResourceByName(
          "MySurface", 
          DXGI_SHARED_RESOURCE_READ, 
          __uuidof(ID3D11Texture2D), 
         (void**)&pTexture2D);