IPropertySetter::GetProps 메서드
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
참고
[더 이상 사용되지 않습니다. 이 API는 향후 Windows 릴리스에서 제거될 수 있습니다.]
메서드는 GetProps 해당 값을 사용하여 이 개체에 설정된 속성을 검색합니다.
구문
HRESULT GetProps(
[out] LONG *pcParams,
[out] DEXTER_PARAM **paParam,
[out] DEXTER_VALUE **paValue
);
매개 변수
-
pcParams [out]
-
paParam에서 반환된 구조체의 수를 받습니다.
-
paParam [out]
-
DEXTER_PARAM 구조체 배열에 대한 포인터의 주소입니다.
-
paValue [out]
-
DEXTER_VALUE 구조체 배열에 대한 포인터의 주소입니다.
반환 값
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
paParam에서 반환된 각 속성에 대해 nValues 멤버는 속성과 연결된 DEXTER_VALUE 구조체의 수를 나타냅니다. 쌍은 각 속성에 대해 오름차순으로 반환됩니다.
반환된 구조체 사용을 마치면 IPropertySetter::FreeProps 를 호출하여 이 메서드에서 할당한 리소스를 해제합니다.
참고
헤더 파일 Qedit.h는 버전 7 이후의 Direct3D 헤더와 호환되지 않습니다.
참고
Qedit.h를 가져오려면 Windows Vista용 Microsoft Windows SDK 업데이트를 다운로드하고 3.0을 .NET Framework. Qedit.h는 Windows 7 및 .NET Framework 3.5 서비스 팩 1용 Microsoft Windows SDK 사용할 수 없습니다.
예제
다음 코드 예제에서는 속성 setter의 instance 모든 값을 반복하는 방법을 보여줍니다.
IPropertySetter *pSetter = NULL;
// Get a valid IPropertySetter pointer (not shown).
DEXTER_PARAM *pParam;
DEXTER_VALUE *pValue;
LONG count;
hr = pSetter->GetProps(&count, &pParam, &pValue);
LONG num = 0;
for (LONG i = 0; i < count; i++)
{
for (LONG j = 0; j < pParam[i].nValues; j++)
{
// pValue[num] is the next value in the sequence for pParam[i]
}
num += pParam[i].nValues;
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|
추가 정보