IDMLObject::GetPrivateData メソッド (directml.h)

DirectML デバイスオブジェクトからアプリケーション定義データを取得します。このメソッドはスレッドセーフです。

構文

HRESULT GetPrivateData(
  [in]            REFGUID guid,
  [in, out]       UINT    *dataSize,
  [out, optional] void    *data
);

[in] guid

型: REFGUID

データに関連付けられている GUID 。

[in, out] dataSize

型: UINT*

入力時に、 データ が指すバッファーのサイズ (バイト単位)、出力時に GetPrivateData が取得したデータ量のサイズ (バイト単位) を含む変数へのポインター。

[out, optional] data

型: void*

dataSize がデータを保持するのに十分な大きさのバッファーを指定する値を指している場合に、デバイスオブジェクトからデータを受信するメモリブロックへのポインター。

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

返されるデータが、SetPrivateDataInterface によって以前に設定された IUnknown (または派生インターフェイス) へのポインターである場合、そのインターフェイスの参照カウントは、プライベートデータが返される前にインクリメントされます。