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.h 和 dsound.h 定義類似但不相容的 IKsPropertySet 介面版本。 需要 KS Proxy 模組的應用程式應該使用 ksproxy.h 中定義的版本。 如果應用程式必須同時包含 ksproxy.h 和 dsound.h,則編譯程式會先掃描哪一個頭檔是編譯程式使用 IKsPropertySet 的定義。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | ksproxy.h (包含 Ksproxy.h、Dsound.h) |