KsGetMultiplePinFactoryItems 関数 (ksproxy.h)

KsGetMultiplePinFactoryItems 関数は、可変長データ バッファー内の pin プロパティ項目を取得します。

構文

KSDDKAPI HRESULT KsGetMultiplePinFactoryItems(
  [in]  HANDLE FilterHandle,
  [in]  ULONG  PinFactoryId,
  [in]  ULONG  PropertyId,
  [out] PVOID  *Items
);

パラメーター

[in] FilterHandle

クエリを実行するピン ファクトリを含むフィルターを処理します。

[in] PinFactoryId

プロパティ項目が返されるピン ファクトリの識別子。

[in] PropertyId

クエリを実行する pin プロパティ セット (KSPROPSETID_Pin) 内のプロパティの識別子。

[out] Items

プロパティ項目を受け取るバッファーへのポインター。 正常に取得された場合、このポインターは後で CoTaskMemFree 関数を使用して削除する必要があります。

戻り値

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

備考

KsGetMultiplePinFactoryItems 関数は、要求されたプロパティのデータ サイズ (バイト単位) を照会し、バッファーを割り当て、データを取得します。

CoTaskMemFree の詳細については、Microsoft Windows SDK のドキュメントを参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー ksproxy.h (Ksproxy.h を含む)
ライブラリ Ksproxy.lib

関連項目

IKsPinFactory

KSPROPERTY を する

KSPROPSETID_Pin

KSP_PIN