다음을 통해 공유

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

  • 아티클

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

구문

HRESULT Get(
  [in]  REFGUID rguidPropSet,
  [in]  ULONG   ulId,
  [in]  LPVOID  pInstanceData,
  [in]  ULONG   ulInstanceLength,
  [out] LPVOID  pPropertyData,
  [in]  ULONG   ulDataLength,
  [out] PULONG  pulBytesReturned
);

매개 변수

[in] rguidPropSet

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

[in] ulId

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

[in] pInstanceData

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

[in] ulInstanceLength

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

[out] pPropertyData

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

[in] ulDataLength

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

[out] pulBytesReturned

Get이 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 정의를 사용하는 헤더 파일입니다.

요구 사항

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

추가 정보

IKsPropertySet::Set