共用方式為


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

規格需求

需求
目標平台 DesktopMobile
標頭 ks.h (包含 Ks.h)

另請參閱

KSPROPERTY

KSPROPERTY_ITEM

KSPROPERTY_SET