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

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

반환 값

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

발언

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

요구 사항

요구	값
대상 플랫폼	DesktopMobile
헤더	ksproxy.h(Ksproxy.h 포함)

참고 항목

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S