IDXGIKeyedMutex

キー付きミューテックスを表します。これは、複数のデバイスで使用される共有リソースへの排他アクセスを可能にします。

IDXGIKeyedMutex インターフェイスをサポートできるリソースを作成するには、IDXGIFactory1 が必要です。

IDXGIKeyedMutex は、リソースを共有する各デバイスごとに取得する必要があります。Direct3D 10.1 では、2 つ以上のデバイス間で共有されるこのようなリソースは、D3D10_RESOURCE_MISC_SHARED_KEYEDMUTEX フラグを使用して作成されます。Direct3D 11 では、2 つ以上のデバイス間で共有されるこのようなリソースは、D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX フラグを使用して作成されます。

キー付きミューテックスの作成については、IDXGIKeyedMutex::AcquireSync メソッドを参照してください。

キーを使用して、共有リソースへの排他的なレンダリングアクセスを取得します。

Type: HRESULT

成功した場合は S_OK を返します。

所有しているデバイスが同じ共有リソース上に別のキー付きミューテックスを作成しようとした場合、AcquireSync は E_FAIL を返します。

AcquireSync は、次の DWORD 定数を返すこともあります。したがって、これらの定数を明示的にチェックする必要があります。戻り値に対して SUCCEEDED マクロのみを使用して AcquireSync が成功したかどうかを判断すると、これらの定数を検出できません。

• WAIT_ABANDONED - 共有サーフェスとキー付きミューテックスが一貫した状態ではなくなっています。AcquireSync がこの値を返した場合は、キー付きミューテックスと共有サーフェスの両方を解放して再作成する必要があります。
• WAIT_TIMEOUT - 指定したキーが解放される前にタイムアウト間隔が経過しました。

AcquireSync メソッドは、複数のデバイス間で共有されるサーフェスに対するロックを作成し、一度に 1 つのデバイスのみがサーフェスにレンダリングできるようにします。このメソッドは、どのデバイスが現在サーフェスへの排他アクセスを持っているかを判断するためにキーを使用します。

D3D10_RESOURCE_MISC_FLAG 列挙型の D3D10_RESOURCE_MISC_SHARED_KEYEDMUTEX 値を使用してサーフェスを作成した場合は、サーフェスにレンダリングする前に AcquireSync メソッドを呼び出す必要があります。サーフェスへのレンダリングが完了したら、ReleaseSync メソッドを呼び出す必要があります。

共有リソースのキー付きミューテックスオブジェクトへの参照を取得するには、リソースの QueryInterface メソッドを呼び出し、IDXGIKeyedMutex インターフェイスの UUID を渡します。この参照の取得の詳細については、次のコード例を参照してください。

AcquireSync メソッドは、サーフェスの状態に応じて、次のようにキーを使用します。

• 最初の作成時、サーフェスはどのデバイスにも所有されておらず、任意のデバイスが AcquireSync メソッドを呼び出してアクセスを取得できます。所有されていないサーフェスに対しては、キー 0 のみが成功します。その他のキーで AcquireSync メソッドを呼び出すと、呼び出し元の CPU スレッドが停止します。
• AcquireSync メソッドを呼び出したときにサーフェスがあるデバイスによって所有されている場合、AcquireSync メソッドを呼び出した CPU スレッドは、所有しているデバイスが同じ Key を使用して ReleaseSync メソッドを呼び出すまで停止します。
• AcquireSync メソッドを呼び出したときにサーフェスが所有されていない場合(たとえば、最後に所有していたデバイスがすでに ReleaseSync メソッドを呼び出している場合)、最後に ReleaseSync メソッドが呼び出されたときに指定されたのと同じキーを指定すれば、AcquireSync メソッドは成功します。その他のキーで AcquireSync メソッドを呼び出すと、停止が発生します。
• 所有しているデバイスが特定のキーで ReleaseSync メソッドを呼び出し、同じキーを使用して AcquireSync メソッドを呼び出した後に複数のデバイスが待機している場合、待機しているデバイスのいずれか 1 つが最初に起こされる可能性があります。デバイスが起こされる順序は未定義です。
• キー付きミューテックスは、AcquireSync メソッドの再帰呼び出しをサポートしません。

例

キー付きミューテックスの取得

次のコード例は、共有リソースへのロックを取得する方法と、解放時にキーを指定する方法を示しています。

// pDesc はテクスチャの記述で既にセットアップされています。
pDesc.MiscFlags = D3D10_RESOURCE_MISC_SHARED_KEYEDMUTEX;

// 共有テクスチャリソースを作成します。
pD3D10DeviceD->CreateTexture2D(pDesc, NULL, pD3D10Texture);

// キー付きミューテックスへの参照を取得します。
pD3D10Texture->QueryInterface(_uuidof(IDXGIKeyedMutex), pDXGIKeyedMutex);

// リソースへのロックを取得します。
pDXGIKeyedMutex->AcquireSync(0, INFINITE);

// ロックを解放し、キーを指定します。
pDXGIKeyedMutex->ReleaseSync(1);
          

キーを使用して、共有リソースへの排他的なレンダリングアクセスを解放します。

Type: HRESULT

成功した場合は S_OK を返します。

デバイスが、有効でない、またはそのデバイスが所有していないキー付きミューテックスを解放しようとした場合、ReleaseSync は E_FAIL を返します。

ReleaseSync メソッドは、複数のデバイス間で共有されるサーフェスに対するロックを解放します。このメソッドは、どのデバイスが現在サーフェスへの排他アクセスを持っているかを判断するためにキーを使用します。

D3D10_RESOURCE_MISC_FLAG 列挙型の D3D10_RESOURCE_MISC_SHARED_KEYEDMUTEX 値を使用してサーフェスを作成した場合は、サーフェスにレンダリングする前に IDXGIKeyedMutex::AcquireSync メソッドを呼び出す必要があります。サーフェスへのレンダリングが完了したら、ReleaseSync メソッドを呼び出す必要があります。

ReleaseSync メソッドを呼び出すと、共有リソースはレンダリングパイプラインから解除されます。

共有リソースのキー付きミューテックスオブジェクトへの参照を取得するには、リソースの QueryInterface メソッドを呼び出し、IDXGIKeyedMutex インターフェイスの UUID を渡します。この参照の取得の詳細については、次のコード例を参照してください。

例

キー付きミューテックスの取得

次のコード例は、共有リソースへのロックを取得する方法と、解放時にキーを指定する方法を示しています。

// pDesc はテクスチャの記述で既にセットアップされています。
pDesc.MiscFlags = D3D10_RESOURCE_MISC_SHARED_KEYEDMUTEX;

// 共有テクスチャリソースを作成します。
pD3D10DeviceD->CreateTexture2D(pDesc, NULL, pD3D10Texture);

// キー付きミューテックスへの参照を取得します。
pD3D10Texture->QueryInterface(_uuidof(IDXGIKeyedMutex), pDXGIKeyedMutex);

// リソースへのロックを取得します。
pDXGIKeyedMutex->AcquireSync(0, INFINITE);

// ロックを解放し、キーを指定します。
pDXGIKeyedMutex->ReleaseSync(1);