ISpecifyPropertyPages Interface

Description

Provides a list of ActiveGige property pages supported by the Video Capture Filter and Video Capture Pin. Property pages provide a built-in camera control GUI to DirectShow compatible applications.


Methods

HRESULT GetPages( CAUUID *pPages )

Fills an array of GUID values where each GUID specifies the CLSID of a corresponding ActiveGige property page.

Parameters

pPages

[out] Pointer to a caller-allocated CAUUID structure that must be initialized and filled before returning. The pElems field in the CAUUID structure is allocated by the callee with CoTaskMemAlloc and freed by the caller with CoTaskMemFree.

Return Values

S_OK

Success

E_POINTER

The address in pPages is not valid.

Example

This C++ code displays built-in property pages for the Video Capture pin:

ISpecifyPropertyPages *pSpec;
CAUUID cauuid;
IAMStreamConfig *pSC;
hr =pBuilder->FindInterface(&PIN_CATEGORY_CAPTURE, &MEDIATYPE_Video,
   pFilter, IID_IAMStreamConfig, (void **)&pSC);
if (FAILED(hr))
{
Error( "Capture pin not found" );
return FALSE;
}
hr = pFilter->QueryInterface(IID_ISpecifyPropertyPages, (void **)&pSpec);
if(hr == S_OK)
{
   hr = pSpec->GetPages(&cauuid);
   hr = OleCreatePropertyFrame(ghwndApp, 30, 30, NULL, 1,
   (IUnknown **)&pSC, cauuid.cElems,
   (GUID *)cauuid.pElems, 0, 0, NULL);
   CoTaskMemFree(cauuid.pElems);
   pSpec->Release();
}
Remarks

Video Capture Filter supports the Exposure and Color property pages. Video Capture Pin supports the Source, Format and Advanced property pages. Refer to ActiveX Reference chapter for more information.