ID3D11Fence::CreateSharedHandle メソッド (d3d11_3.h)
フェンス オブジェクトへの共有ハンドルを作成します。
このメソッドは、Direct3D 12 ID3D12Device::CreateSharedHandle メソッドと同等であり、Direct3D 11 と Direct3D 12間の相互運用を伴うシナリオで適用されます。 DirecX 11 では、 ID3D11Device5::OpenSharedFence メソッドを使用して共有フェンス ハンドルを開くことができます。 DirecX 12 では、 ID3D12Device::OpenSharedHandle メソッドを使用して共有フェンス ハンドルを開くことができます。
構文
HRESULT CreateSharedHandle(
[in, optional] const SECURITY_ATTRIBUTES *pAttributes,
DWORD dwAccess,
[in, optional] LPCWSTR lpName,
[out] HANDLE *pHandle
);
パラメーター
[in, optional] pAttributes
型: const SECURITY_ATTRIBUTES*
2 つの独立した関連データ メンバーを含む SECURITY_ATTRIBUTES 構造体へのポインター。省略可能なセキュリティ記述子と、子プロセスが返されたハンドルを継承できるかどうかを決定する ブール 値。
アプリケーションが作成する子プロセスが CreateSharedHandle によって返されるハンドルを継承しないようにする場合、および返されるハンドルに関連付けられているリソースで既定のセキュリティ記述子を取得する場合は、このパラメーターを NULL に設定します。
構造体の lpSecurityDescriptor メンバーは、リソースの SECURITY_DESCRIPTOR を指定します。 返されたハンドルに関連付けられているリソースに既定のセキュリティ記述子をランタイムが割り当てる場合は、このメンバーを NULL に設定します。 リソースの既定のセキュリティ記述子の ACL は、作成者のプライマリ トークンまたは偽装トークンから取得されます。 詳細については、「 同期オブジェクトのセキュリティとアクセス権」を参照してください。
dwAccess
型: DWORD
現在、このパラメーターが受け入れる値はGENERIC_ALLのみです。
[in, optional] lpName
種類: LPCWSTR
共有ヒープに関連付ける名前を含む NULL で終わる UNICODE 文字列。 名前はMAX_PATH文字に制限されています。 名前の比較では大文字と小文字が区別されます。
Name が既存のリソースの名前と一致する場合、CreateSharedHandle はDXGI_ERROR_NAME_ALREADY_EXISTSで失敗します。 これは、これらのオブジェクトが同じ名前空間を共有しているために発生します。
名前には、グローバル名前空間またはセッション名前空間にオブジェクトを明示的に作成するための "Global" または "Local" プレフィックスを付けることができます。 名前の残りの部分には、円記号 (\) を除く任意の文字を含めることができます。 詳細については、「 カーネル オブジェクトの名前空間」を参照してください。 高速ユーザー切り替えは、ターミナル サービス セッションを使用して実装されます。 カーネル オブジェクト名は、アプリケーションが複数のユーザーをサポートできるように、ターミナル サービスに関して説明されているガイドラインに従う必要があります。
オブジェクトはプライベート名前空間に作成できます。 詳細については、「 オブジェクト名前空間」を参照してください。
[out] pHandle
型: HANDLE*
共有するリソースに NT HANDLE 値を受け取る変数へのポインター。 このハンドルを呼び出しで使用して、リソースにアクセスできます。
戻り値
型: HRESULT
成功した場合はS_OKを返します。それ以外の場合は、次のいずれかの値を返します。
- いずれかの パラメーターが無効な場合にDXGI_ERROR_INVALID_CALLします。
- 共有 するリソースの指定された名前が既に別のリソースに関連付けられている場合にDXGI_ERROR_NAME_ALREADY_EXISTSします。
- オブジェクトが保護された名前空間に作成されている場合にE_ACCESSDENIEDします。
- ハンドルを作成するのに十分なメモリが使用できない場合にE_OUTOFMEMORYします。
- Direct3D 11 のリターン コードに関するトピックで説明されているその他のエラー コードが考えられます。
注釈
指定したフェンスの共有ハンドルを作成するには、フェンスが D3D11_FENCE_FLAG_SHARED または D3D11_FENCE_FLAG_SHARED_CROSS_ADAPTER フラグを使用して作成されている必要があります。 詳細については、 D3D11_FENCE_FLAG 列挙を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d11_3.h |
| Library | D3D11.lib |
| [DLL] | D3D11.dll |