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
在 Property 指定緩衝區的大小,以位元組為單位。
[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) |