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 포함) |