winrt::copy_to_abi 関数 (C++/WinRT)

C++/WinRT オブジェクトからハンドルまたはポインターにコピーするヘルパー関数。 現在参照されているインターフェイスの参照カウントをインクリメントし、そのインターフェイスのメモリ アドレスをパラメーターにコピーします (パラメーターの参照カウントをインクリメントします)。 この関数を使用すると、 QueryInterface を呼び出さずに、同じインターフェイスへの参照を渡します。 詳細とコード例については、「 C++/WinRT と ABI の相互運用」を参照してください。

構文

template <typename T, typename V, typename =
std::enable_if_t<!std::is_base_of_v<winrt::Windows::Foundation::IUnknown, T>>>
void copy_to_abi(T const& object, V& value);

void copy_to_abi(hstring const& object, void*& value);

void copy_to_abi(winrt::Windows::Foundation::IUnknown const& object, void*& value) noexcept;

パラメーター

object 操作する C++/WinRT オブジェクト。

value ハンドル参照、または生ポインター参照。を使用して、C++/WinRT オブジェクトのハンドルまたはターゲットへのポインターをコピーします。 オーバーロードのIUnknown const&, void*&場合、関数はに対して AddRef を呼び出します。

必要条件

サポートされている最小 SDK: Windows SDK バージョン 10.0.17134.0 (Windows 10、バージョン 1803)

名前空間: winrt

ヘッダー: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (既定で含まれます)

こちらもご覧ください