IKsPropertySet::Get 메서드

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

Get 메서드는 속성 집합 GUID 및 속성 ID로 식별되는 속성을 검색합니다.

구문

HRESULT Get(
  [in]  REFGUID guidPropSet,
  [in]  DWORD   dwPropID,
  [in]  LPVOID  pInstanceData,
  [in]  DWORD   cbInstanceData,
  [out] LPVOID  pPropData,
  [in]  DWORD   cbPropData,
  [out] DWORD   *pcbReturned
);

매개 변수

guidPropSet [in]

속성 집합 의 GUID입니다.

dwPropID [in]

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

pInstanceData [in]

속성에 대한 instance 데이터를 포함하는 바이트 배열에 대한 포인터입니다.

cbInstanceData [in]

pInstanceData에 지정된 배열의 크기(바이트)입니다.

pPropData [out]

속성 데이터를 수신하는 바이트 배열에 대한 포인터입니다.

cbPropData [in]

pPropData에 지정된 배열의 크기(바이트)입니다.

pcbReturned [out]

메서드가 pPropData 배열에 복사하는 바이트 수를 받습니다.

반환 값

HRESULT 값을 반환합니다. 가능한 값은 다음과 같습니다.

반환 코드	Description
S_OK	성공.
E_PROP_SET_UNSUPPORTED	속성 집합은 지원되지 않습니다.
E_PROP_ID_UNSUPPORTED	속성 ID는 지정된 속성 집합에 대해 지원되지 않습니다.

 

설명

참고

이 이름의 다른 인터페이스는 dsound.h 헤더 파일에 있습니다. 두 인터페이스는 호환되지 않습니다. DirectShow DDK에 설명된 IKsControl 인터페이스는 이제 WDM 드라이버와 사용자 모드 구성 요소 간에 속성 집합을 전달하는 데 권장되는 인터페이스입니다.

 

속성을 검색하려면 이 메서드가 채울 버퍼를 할당합니다. 필요한 버퍼 크기를 확인하려면 pPropData에 NULL을, cbPropData에 0을 지정합니다. 이 메서드는 pcbReturned에서 필요한 버퍼 크기를 반환합니다.

Ksproxy.h 앞에 Ks.h를 포함해야 합니다.

예제

다음 예제에서는 AMPROPERTY_PIN_CATEGORY 속성을 검색하여 핀 범주에 대한 핀을 쿼리합니다. ( Pin 속성 집합을 참조하세요.)

HRESULT GetPinCategory(IPin *pPin, GUID *pPinCategory)
{
    IKsPropertySet *pKs = NULL;

    HRESULT hr = pPin->QueryInterface(IID_PPV_ARGS(&pKs));
    if (FAILED(hr))
    {
        return hr;
    }

    // Try to retrieve the pin category.
    DWORD cbReturned = 0;
    hr = pKs->Get(AMPROPSETID_Pin, AMPROPERTY_PIN_CATEGORY, NULL, 0, 
        pPinCategory, sizeof(GUID), &cbReturned);
    
    // If this succeeded, pPinCategory now contains the category GUID.

    SafeRelease(&pKs);
    return hr;
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	Ksproxy.h
라이브러리	Strmiids.lib

추가 정보

오류 및 성공 코드

IKsPropertySet 인터페이스

속성 집합