共用方式為


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 設為 NULLDataLength 等於零。 方法會傳回HRESULT_FROM_WIN32(ERROR_MORE_DATA),BytesReturned 包含所需緩衝區的大小。

要求

要求 價值
目標平臺 DesktopMobile
標頭 ks.h (包括 Ks.h)

另請參閱

KSPROPERTY

KSPROPERTY_ITEM

KSPROPERTY_SET