IKsControl::KsProperty 方法 (ks.h)
IKsControl::KsProperty 方法會設定屬性或擷取屬性資訊,以及屬性集上可用的任何其他已定義支持作業。
語法
NTSTATUS KsProperty(
[in] PKSPROPERTY Property,
[in] ULONG PropertyLength,
[in, out] PVOID PropertyData,
[in] ULONG DataLength,
[out] ULONG *BytesReturned
);
參數
[in] Property
描述屬性和屬性要求之要求類型的結構指標。 此結構必須是 KSPROPERTY,或是包含 KSPROPERTY 結構做為其第一個成員的結構。 這個成員可指向的結構範例是 KSPROPERTY_VIDEOPROCAMP_S 結構。
[in] PropertyLength
指定 屬性緩衝區的大小,以位元組為單位。
[in, out] PropertyData
緩衝區的指標,其中包含KSPROPERTY_TYPE_SET、KSPROPERTY_TYPE_UNSERIALIZESET或KSPROPERTY_TYPE_UNSERIALIZERAW作業的數據,或接收所有其他作業數據的緩衝區空間。
[in] DataLength
指定 PropertyData緩衝區的大小,以位元組為單位。
[out] BytesReturned
接收 KsProperty 數據大小之變數的指標, 儲存在 PropertyData的緩衝區中。 如果未儲存任何數據,則大小為零。
傳回值
IKsControl::KsProperty 方法會傳回相同的值,如果 IOCTL 已傳送屬性,則會傳回該值。
言論
若要判斷特定屬性要求所需的緩衝區大小,您可以呼叫這個方法,並將 propertyData 設為 NULL,DataLength 等於零。 方法會傳回HRESULT_FROM_WIN32(ERROR_MORE_DATA),BytesReturned 包含所需緩衝區的大小。
要求
要求 | 價值 |
---|---|
目標平臺 | DesktopMobile |
標頭 | ks.h (包括 Ks.h) |