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

Property에서 버퍼의 크기(바이트) 입니다.

[in, out] PropertyData

KSPROPERTY_TYPE_SET, KSPROPERTY_TYPE_UNSERIALIZESET 또는 KSPROPERTY_TYPE_UNSERIALIZERAW 작업에 대한 데이터를 포함하는 버퍼 또는 다른 모든 작업에 대한 데이터를 수신하는 버퍼 공간에 대한 포인터입니다.

[in] DataLength

PropertyData의 버퍼 크기(바이트)입니다.

[in, out] BytesReturned

KsProperty가 PropertyData의 버퍼에 저장하는 데이터의 크기(바이트)를 수신하는 변수에 대한 포인터입니다. 데이터가 저장되지 않으면 크기는 0입니다.

반환 값

성공하면 NOERROR를 반환합니다. 그렇지 않으면 은 오류 코드를 반환합니다.

설명

특정 속성 요청에 필요한 버퍼 크기를 확인하려면 PropertyData 가 NULL 로 설정되고 DataLength 가 0으로 설정된 상태에서 이 메서드를 호출할 수 있습니다. 메서드는 HRESULT_FROM_WIN32(ERROR_MORE_DATA)를 반환하고 BytesReturned 에는 필요한 버퍼의 크기가 포함됩니다.

요구 사항

요구 사항	값
대상 플랫폼	DesktopMobile
머리글	ksproxy.h(Ksproxy.h 포함)

추가 정보

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S