次の方法で共有

DCompositionCreateSurfaceHandle 関数 (dcomp.h)

  • [アーティクル]

Microsoft DirectX スワップ チェーンまたはスワップ バッファーにバインドしてビジュアルに関連付けることができる新しいコンポジション サーフェス オブジェクトを作成します。

構文

HRESULT DCompositionCreateSurfaceHandle(
  [in]           DWORD               desiredAccess,
  [in, optional] SECURITY_ATTRIBUTES *securityAttributes,
  [out]          HANDLE              *surfaceHandle
);

パラメーター

[in] desiredAccess

型: DWORD

コンポジション サーフェス オブジェクトへの要求されたアクセス。 次のいずれかの値を指定できます。

価値 意味
0x0000L
 アクセスなし。
COMPOSITIONOBJECT_READ
0x0001L
 読み取りアクセス。 内部使用のみ。
COMPOSITIONOBJECT_WRITE
0x0002L
 書き込みアクセス。 内部使用のみ。
COMPOSITIONOBJECT_ALL_ACCESS
0x0003L
 読み取り/書き込みアクセス。 別のプロセスでサーフェスを複製する場合を除き、常にこのフラグを指定します。その場合は、desiredAccess 0 に設定します。

[in, optional] securityAttributes

型: SECURITY_ATTRIBUTES*

コンポジション サーフェス オブジェクトのセキュリティ記述子を格納し、子プロセスの作成時にコンポジション サーフェス オブジェクトのハンドルを継承できるかどうかを指定します。 このパラメーターが NULL の場合、コンポジション サーフェス オブジェクトは、現在のプロセスへの読み取りと書き込みアクセスを許可する既定のセキュリティ属性を使用して作成されますが、子プロセスでハンドルを継承することはできません。

[out] surfaceHandle

型: HANDLE*

新しいコンポジション サーフェス オブジェクトのハンドル。 このパラメーターは NULL にすることはできません。

戻り値

型: HRESULT

関数が成功すると、S_OKが返されます。 それ以外の場合は、HRESULT エラー コードが返されます。 エラー コード 一覧については、「DirectComposition エラー コードの」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 8 [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2012 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー dcomp.h
ライブラリ Dcomp.lib
DLL Dcomp.dll