IKsControl::KsProperty メソッド (ksproxy.h)

  • [アーティクル]

KsProperty メソッドは、プロパティを設定するか、プロパティ セットで使用できる他の定義されたサポート操作と共にプロパティ情報を取得します。

構文

HRESULT KsProperty(
  [in]      PKSPROPERTY Property,
  [in]      ULONG       PropertyLength,
  [in, out] LPVOID      PropertyData,
  [in]      ULONG       DataLength,
  [in, out] ULONG       *BytesReturned
);

パラメーター

[in] Property

プロパティとプロパティ要求の要求の種類を記述する構造体へのポインター。 この構造体は、 KSPROPERTY または KSPROPERTY 構造体を最初のメンバーとして含む構造体のいずれかである必要があります。 このメンバーが指し示すことができる構造体の例として、 KSPROPERTY_VIDEOPROCAMP_S 構造体があります。

[in] PropertyLength

Property のバッファーのサイズ (バイト単位)。

[in, out] PropertyData

KSPROPERTY_TYPE_SET、KSPROPERTY_TYPE_UNSERIALIZESET、またはKSPROPERTY_TYPE_UNSERIALIZERAW操作のデータを含むバッファー、または他のすべての操作のデータを受信するバッファー領域へのポインター。

[in] DataLength

PropertyData のバッファーのサイズ (バイト単位)。

[in, out] BytesReturned

KsProperty が PropertyData のバッファーに格納するデータのサイズをバイト単位で受け取る変数へのポインター。 データが格納されていない場合、サイズは 0 です。

戻り値

成功した場合は NOERROR を返します。それ以外の場合は、エラー コードを返します。

注釈

特定のプロパティ要求に必要なバッファー サイズを決定するには、 PropertyData を NULL に設定し、 DataLength を 0 に設定してこのメソッドを呼び出します。 メソッドは HRESULT_FROM_WIN32(ERROR_MORE_DATA) を返し、 BytesReturned には必要なバッファーのサイズが含まれています。

要件

要件 値
対象プラットフォーム DesktopMobile
Header ksproxy.h (Ksproxy.h を含む)

こちらもご覧ください

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S