피드백

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

  • 아티클
  • 읽는 데 2분 걸림

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

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

[in] InstanceLength

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

[out] PropertyData

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

[in] DataLength

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

[out] BytesReturned

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

반환 값

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

설명

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

경고

헤더 파일 ksproxy.h 및 dsound.h 는 IKsPropertySet 인터페이스의 유사하지만 호환되지 않는 버전을 정의합니다. KS 프록시 모듈이 필요한 애플리케이션은 ksproxy.h에 정의된 버전을 사용해야 합니다. IKsPropertySet의 DirectSound 버전은 Microsoft Windows SDK 설명서의 DirectSound 참조 페이지에 설명되어 있습니다.

애플리케이션에 ksproxy.h 와 dsound.h가 모두 포함되어야 하는 경우 컴파일러가 먼저 검색하는 헤더 파일은 컴파일러에서 IKsPropertySet 정의를 사용하는 헤더 파일입니다.

요구 사항

   
대상 플랫폼 데스크톱
헤더 ksproxy.h(Ksproxy.h, Dsound.h 포함)

참고 항목

IKsPropertySet::Set