ISpecifyPropertyPages Interface
Top  Previous  Next

Description

Provides a list of ActiveGeni 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 ActiveGeni 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.