IPart::GetControlInterface メソッド (devicetopology.h)

GetControlInterface メソッドは、指定したコントロール インターフェイスへの参照を取得します (この部分でサポートされている場合)。

構文

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

パラメーター

[in] nIndex

コントロール インターフェイス番号。 パーツが n 個のコントロール インターフェイスをサポートしている場合、コントロール インターフェイスには 0 から n – 1 の番号が付けます。

[out] ppInterfaceDesc

メソッドが指定したオーディオ関数の IControlInterface インターフェイスのアドレスを書き込むポインター変数へのポインター。 このメソッドを使用して、呼び出し元はインターフェイスへのカウントされた参照を取得します。 呼び出し元は、インターフェイスの Release メソッドを呼び出すことによって、不要になったインターフェイスを解放する必要があります。 GetControlInterface 呼び出しが失敗した場合、*ppFunction は NULL です。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

要件

関連項目

IControlInterface インターフェイス

IPart インターフェイス