IKsControl:: KsProperty 方法 (ksproxy .h)

KsProperty方法會設定屬性,或抓取屬性資訊,以及屬性集上可用的任何其他已定義支援作業。

語法

HRESULT KsProperty(
  [in]      PKSPROPERTY Property,
  [in]      ULONG       PropertyLength,
  [in, out] LPVOID      PropertyData,
  [in]      ULONG       DataLength,
  [in, 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

[in, out] BytesReturned

變數的指標,此變數會接收 KsProperty 儲存在 PropertyData之緩衝區中的資料大小(以位元組為單位)。 如果未儲存任何資料,則大小為零。

傳回值

如果成功,則傳回 >AAD-USERREADUSINGALTERNATIVESECURITYID-NOERROR;否則,會傳回錯誤碼。

備註

若要判斷特定屬性要求所需的緩衝區大小,您可以呼叫這個方法,並將 PropertyData 設定為 Null ,而 DataLength 等於零。 方法會傳回 HRESULT_FROM_WIN32 (ERROR_MORE_DATA) ,而 BytesReturned 包含所需的緩衝區大小。

規格需求

   
目標平台 DesktopMobile
標頭 ksproxy (包含 Ksproxy)

另請參閱

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S