다음을 통해 공유

IKsPropertySet::Get 메서드(ksproxy.h)

  • 아티클

Get 메서드는 속성 집합 GUID 및 속성 식별자에 의해 식별되는 속성을 검색합니다.

구문

HRESULT Get(
  [in]  REFGUID PropSet,
  [in]  ULONG   Id,
  [in]  LPVOID  InstanceData,
  [in]  ULONG   InstanceLength,
  [out] LPVOID  PropertyData,
  [in]  ULONG   DataLength,
  [out] ULONG   *BytesReturned
);

매개 변수

[in] PropSet

속성 집합을 식별하는 GUID입니다.

[in] Id

속성 집합 내의 속성 식별자입니다.

[in] InstanceData

속성의 instance 데이터에 대한 포인터입니다.

[in] InstanceLength

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

[out] PropertyData

속성 값을 받는 버퍼에 대한 포인터입니다.

[in] DataLength

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

[out] BytesReturned

Get이 PropertyData의 버퍼에 저장하는 데이터의 크기(바이트)를 수신하는 변수에 대한 포인터입니다.

반환 값

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

설명

속성을 검색하려면 속성으로 채우기 를 가져오는 버퍼를 할당합니다. 필요한 버퍼 크기를 확인하려면 PropertyData에 NULL을, DataLength에 0을 지정합니다. Get 메서드는 BytesReturned에서 필요한 버퍼 크기를 반환합니다.

경고

헤더 파일 ksproxy.h 및 dsound.h 는 유사하지만 호환되지 않는 IKsPropertySet 인터페이스 버전을 정의합니다. KS 프록시 모듈이 필요한 애플리케이션은 ksproxy.h에 정의된 버전을 사용해야 합니다. 애플리케이션에 ksproxy.h 와 dsound.h가 모두 포함되어야 하는 경우 컴파일러가 먼저 검색하는 헤더 파일은 컴파일러 에서 IKsPropertySet 정의를 사용하는 헤더 파일입니다.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 ksproxy.h(Ksproxy.h, Dsound.h 포함)

추가 정보

IKsPropertySet::Set