共用方式為


IKsPropertySet::Get 方法 (ksproxy.h)

Get 方法會擷取屬性集 GUID 和屬性識別碼所識別的屬性。

語法

HRESULT Get(
  [in]  REFGUID PropSet,
  [in]  ULONG   Id,
  [in]  LPVOID  InstanceData,
  [in]  ULONG   InstanceLength,
  [out] LPVOID  PropertyData,
  [in]  ULONG   DataLength,
  [out] ULONG   *BytesReturned
);

參數

[in] PropSet

識別屬性集的 GUID。

[in] Id

屬性集內屬性的標識碼。

[in] InstanceData

屬性實例數據的指標。

[in] InstanceLength

InstanceData 緩衝區的大小,以位元組為單位。

[out] PropertyData

接收 屬性值的緩衝區指標。

[in] DataLength

PropertyData 緩衝區的大小,以位元組為單位。

[out] BytesReturned

變數的指標,該變數會接收 Get 儲存在 PropertyData 緩衝區中的數據大小,以位元組為單位。

傳回值

如果成功,則傳回 NOERROR;否則,會傳回錯誤碼。

備註

若要擷取屬性,請配置緩衝區, 其中 Get 會填入 屬性。 若要判斷必要的緩衝區大小,請針對 PropertyData 指定 NULL,並針對 DataLength 指定零。 Get 方法會傳回 BytesReturned 中所需的緩衝區大小。

警告

頭檔 ksproxy.hdsound.h 定義類似但不相容的 IKsPropertySet 介面版本。 需要 KS Proxy 模組的應用程式應該使用 ksproxy.h 中定義的版本。 如果應用程式必須同時包含 ksproxy.hdsound.h,則編譯程式會先掃描哪一個頭檔是編譯程式使用 IKsPropertySet 的定義。

規格需求

需求
目標平台 桌面
標頭 ksproxy.h (包含 Ksproxy.h、Dsound.h)

另請參閱

IKsPropertySet::Set