IMFDeviceTransform::InitializeTransform メソッド (mftransform.h)

InitializeTransform は、デバイス MFT を初期化するために呼び出されます。

構文

HRESULT InitializeTransform(
  [in] IMFAttributes *pAttributes
);

[in] pAttributes

初期化パラメーターを含むキャプチャパイプラインによって渡される属性へのポインターを格納します。次の属性値が関数に渡されます

属性キー	説明
MF_DEVICEMFT_CONNECTED_FILTER_KSCONTROL	前の DeviceTransform オブジェクトの IKsControl インターフェイス。また、有効なパイプラインを作成するために必要な情報を取得するために使用される IMFDeviceTransform も実装します。
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK	ビデオキャプチャドライバーのシンボリックリンクを示します
MF_DEVSOURCE_ATTRIBUTE_FRIENDLY_NAME	デバイスの表示名を指定します。表示名は人間が判読できる文字列で、ユーザーインターフェイスでの表示に適しています。

このメソッドは HRESULT を返します。使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。

リターンコード	説明
S_OK	初期化に成功しました
MF_E_INVALIDREQUEST	現時点では、デバイス MFT は要求をサポートできませんでした。

デバイスの MFT では、この関数を利用して、さまざまな内部オブジェクトと状態を初期化できます。パイプラインでは、入力 IMFAttributes パラメーターを使用して、特定の構成情報を Device MFT に通信することもできます。