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 を含む) |