api/include/ksproxy.h

/*++

Copyright (C) Microsoft Corporation, 1996 - 1999

Module Name:

    ksproxy.h

Abstract:

    Interface definitions for WDM-CSA proxy filters.

--*/

#ifndef __KSPROXY__
#define __KSPROXY__

#ifdef __cplusplus
extern "C" {
#endif

#undef KSDDKAPI
#ifdef _KSDDK_
#define KSDDKAPI
#else // !_KSDDK_
#define KSDDKAPI DECLSPEC_IMPORT
#endif // _KSDDK_

#define STATIC_IID_IKsObject\
    0x423c13a2L, 0x2070, 0x11d0, 0x9e, 0xf7, 0x00, 0xaa, 0x00, 0xa2, 0x16, 0xa1

#define STATIC_IID_IKsPinEx\
    0x7bb38260L, 0xd19c, 0x11d2, 0xb3, 0x8a, 0x00, 0xa0, 0xc9, 0x5e, 0xc2, 0x2e

#define STATIC_IID_IKsPin\
    0xb61178d1L, 0xa2d9, 0x11cf, 0x9e, 0x53, 0x00, 0xaa, 0x00, 0xa2, 0x16, 0xa1
    
#define STATIC_IID_IKsPinPipe\
    0xe539cd90L, 0xa8b4, 0x11d1, 0x81, 0x89, 0x00, 0xa0, 0xc9, 0x06, 0x28, 0x02

#define STATIC_IID_IKsDataTypeHandler\
    0x5ffbaa02L, 0x49a3, 0x11d0, 0x9f, 0x36, 0x00, 0xaa, 0x00, 0xa2, 0x16, 0xa1

#define STATIC_IID_IKsDataTypeCompletion\
    0x827D1A0EL, 0x0F73, 0x11D2, 0xB2, 0x7A, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96

#define STATIC_IID_IKsInterfaceHandler\
    0xD3ABC7E0L, 0x9A61, 0x11D0, 0xA4, 0x0D, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96

#define STATIC_IID_IKsClockPropertySet\
    0x5C5CBD84L, 0xE755, 0x11D0, 0xAC, 0x18, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96

#define STATIC_IID_IKsAllocator\
    0x8da64899L, 0xc0d9, 0x11d0, 0x84, 0x13, 0x00, 0x00, 0xf8, 0x22, 0xfe, 0x8a
    
#define STATIC_IID_IKsAllocatorEx\
    0x091bb63aL, 0x603f, 0x11d1, 0xb0, 0x67, 0x00, 0xa0, 0xc9, 0x06, 0x28, 0x02
    

#ifndef STATIC_IID_IKsPropertySet
#define STATIC_IID_IKsPropertySet\
    0x31EFAC30L, 0x515C, 0x11d0, 0xA9, 0xAA, 0x00, 0xAA, 0x00, 0x61, 0xBE, 0x93
#endif // STATIC_IID_IKsPropertySet

#define STATIC_IID_IKsTopology\
    0x28F54683L, 0x06FD, 0x11D2, 0xB2, 0x7A, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96

#ifndef STATIC_IID_IKsControl
#define STATIC_IID_IKsControl\
    0x28F54685L, 0x06FD, 0x11D2, 0xB2, 0x7A, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96
#endif // STATIC_IID_IKsControl

#define STATIC_IID_IKsAggregateControl\
    0x7F40EAC0L, 0x3947, 0x11D2, 0x87, 0x4E, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96

#define STATIC_CLSID_Proxy \
    0x17CCA71BL, 0xECD7, 0x11D0, 0xB9, 0x08, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96

#ifdef _KS_

#if !defined(__cplusplus) || _MSC_VER < 1100
DEFINE_GUIDEX(IID_IKsObject);

DEFINE_GUIDEX(IID_IKsPin);

DEFINE_GUIDEX(IID_IKsPinEx);

DEFINE_GUIDEX(IID_IKsPinPipe);

DEFINE_GUIDEX(IID_IKsDataTypeHandler);

DEFINE_GUIDEX(IID_IKsDataTypeCompletion);

DEFINE_GUIDEX(IID_IKsInterfaceHandler);

DEFINE_GUIDEX(IID_IKsClockPropertySet);

DEFINE_GUIDEX(IID_IKsAllocator);

DEFINE_GUIDEX(IID_IKsAllocatorEx);

#define IID_IKsQualityForwarder KSCATEGORY_QUALITY
#endif // !defined(__cplusplus) || _MSC_VER < 1100

#define STATIC_IID_IKsQualityForwarder STATIC_KSCATEGORY_QUALITY

typedef enum {
    KsAllocatorMode_User,
    KsAllocatorMode_Kernel
} KSALLOCATORMODE;


typedef enum {
    FramingProp_Uninitialized,
    FramingProp_None,
    FramingProp_Old,
    FramingProp_Ex
} FRAMING_PROP;

typedef FRAMING_PROP *PFRAMING_PROP;


typedef enum {
    Framing_Cache_Update,     // request to bypass cache when read/write
    Framing_Cache_ReadLast,
    Framing_Cache_ReadOrig,
    Framing_Cache_Write
} FRAMING_CACHE_OPS;


typedef struct {
    LONGLONG     MinTotalNominator;  
    LONGLONG     MaxTotalNominator;
    LONGLONG     TotalDenominator;
} OPTIMAL_WEIGHT_TOTALS;

// forward declaration
typedef struct IPin IPin;
typedef struct IKsPin IKsPin;
typedef struct IKsAllocator IKsAllocator;
typedef struct IKsAllocatorEx IKsAllocatorEx;

                      
//
// allocators strategy is defined by graph manager
//
#define AllocatorStrategy_DontCare                      0

//
// what to optimize
//
#define AllocatorStrategy_MinimizeNumberOfFrames        0x00000001
#define AllocatorStrategy_MinimizeFrameSize             0x00000002
#define AllocatorStrategy_MinimizeNumberOfAllocators    0x00000004
#define AllocatorStrategy_MaximizeSpeed                 0x00000008 

//
// factors (flags) defining the Pipes properties
//
#define PipeFactor_None                   0
#define PipeFactor_UserModeUpstream       0x00000001
#define PipeFactor_UserModeDownstream     0x00000002
#define PipeFactor_MemoryTypes            0x00000004
#define PipeFactor_Flags                  0x00000008
#define PipeFactor_PhysicalRanges         0x00000010
#define PipeFactor_OptimalRanges          0x00000020
#define PipeFactor_FixedCompression       0x00000040
#define PipeFactor_UnknownCompression     0x00000080

#define PipeFactor_Buffers                0x00000100
#define PipeFactor_Align                  0x00000200

#define PipeFactor_PhysicalEnd            0x00000400
#define PipeFactor_LogicalEnd             0x00000800


typedef enum {
    PipeState_DontCare,
    PipeState_RangeNotFixed,
    PipeState_RangeFixed,
    PipeState_CompressionUnknown,
    PipeState_Finalized
} PIPE_STATE;


//
// pipe dimensions relative to BeginPin.
//

typedef struct _PIPE_DIMENSIONS {
    KS_COMPRESSION    AllocatorPin;
    KS_COMPRESSION    MaxExpansionPin;
    KS_COMPRESSION    EndPin;
} PIPE_DIMENSIONS, *PPIPE_DIMENSIONS;


typedef enum {
    Pipe_Allocator_None,
    Pipe_Allocator_FirstPin,
    Pipe_Allocator_LastPin,
    Pipe_Allocator_MiddlePin
} PIPE_ALLOCATOR_PLACE;

typedef PIPE_ALLOCATOR_PLACE  *PPIPE_ALLOCATOR_PLACE;


typedef enum {
    KS_MemoryTypeDontCare = 0,
    KS_MemoryTypeKernelPaged,
    KS_MemoryTypeKernelNonPaged,
    KS_MemoryTypeDeviceHostMapped,
    KS_MemoryTypeDeviceSpecific,
    KS_MemoryTypeUser,
    KS_MemoryTypeAnyHost
} KS_LogicalMemoryType;

typedef KS_LogicalMemoryType  *PKS_LogicalMemoryType;


typedef struct _PIPE_TERMINATION {
    ULONG                       Flags;
    ULONG                       OutsideFactors;
    ULONG                       Weigth;            // outside weight
    KS_FRAMING_RANGE            PhysicalRange;
    KS_FRAMING_RANGE_WEIGHTED   OptimalRange;      
    KS_COMPRESSION              Compression;       // relative to the connected pin on a neighboring filter.
} PIPE_TERMINATION;


//
// extended allocator properties 
//
typedef struct _ALLOCATOR_PROPERTIES_EX
    {
    long cBuffers;
    long cbBuffer;
    long cbAlign;
    long cbPrefix;
// new part
    GUID                       MemoryType;         
    GUID                       BusType;            // one of the buses this pipe is using
    PIPE_STATE                 State;                        
    PIPE_TERMINATION           Input;                        
    PIPE_TERMINATION           Output;                       
    ULONG                      Strategy;
    ULONG                      Flags;              
    ULONG                      Weight;
    KS_LogicalMemoryType       LogicalMemoryType;
    PIPE_ALLOCATOR_PLACE       AllocatorPlace;
    PIPE_DIMENSIONS            Dimensions;
    KS_FRAMING_RANGE           PhysicalRange;      // on allocator pin
    IKsAllocatorEx*            PrevSegment;        // doubly-linked list of KS allocators
    ULONG                      CountNextSegments;  // possible multiple dependent pipes
    IKsAllocatorEx**           NextSegments;
    ULONG                      InsideFactors;      // existing factors (different from "don't care")
    ULONG                      NumberPins;                   
} ALLOCATOR_PROPERTIES_EX;

typedef ALLOCATOR_PROPERTIES_EX *PALLOCATOR_PROPERTIES_EX;


#ifdef __STREAMS__

struct DECLSPEC_UUID("5C5CBD84-E755-11D0-AC18-00A0C9223196") IKsClockPropertySet;
#undef INTERFACE
#define INTERFACE IKsClockPropertySet
DECLARE_INTERFACE_(IKsClockPropertySet, IUnknown)
{
    STDMETHOD(KsGetTime)(
        THIS_
        LONGLONG* Time
    ) PURE;
    STDMETHOD(KsSetTime)(
        THIS_
        LONGLONG Time
    ) PURE;
    STDMETHOD(KsGetPhysicalTime)(
        THIS_
        LONGLONG* Time
    ) PURE;
    STDMETHOD(KsSetPhysicalTime)(
        THIS_
        LONGLONG Time
    ) PURE;
    STDMETHOD(KsGetCorrelatedTime)(
        THIS_
        KSCORRELATED_TIME* CorrelatedTime
    ) PURE;
    STDMETHOD(KsSetCorrelatedTime)(
        THIS_
        KSCORRELATED_TIME* CorrelatedTime
    ) PURE;
    STDMETHOD(KsGetCorrelatedPhysicalTime)(
        THIS_
        KSCORRELATED_TIME* CorrelatedTime
    ) PURE;
    STDMETHOD(KsSetCorrelatedPhysicalTime)(
        THIS_
        KSCORRELATED_TIME* CorrelatedTime
    ) PURE;
    STDMETHOD(KsGetResolution)(
        THIS_
        KSRESOLUTION* Resolution
    ) PURE;
    STDMETHOD(KsGetState)(
        THIS_
        KSSTATE* State
    ) PURE;
};


interface DECLSPEC_UUID("8da64899-c0d9-11d0-8413-0000f822fe8a") IKsAllocator;
#undef INTERFACE
#define INTERFACE IKsAllocator
DECLARE_INTERFACE_(IKsAllocator, IUnknown)
{
    STDMETHOD_(HANDLE, KsGetAllocatorHandle)(
        THIS
    ) PURE;
    STDMETHOD_(KSALLOCATORMODE, KsGetAllocatorMode)(
        THIS
    ) PURE;
    STDMETHOD(KsGetAllocatorStatus)(
        THIS_
        PKSSTREAMALLOCATOR_STATUS AllocatorStatus
    ) PURE;
    STDMETHOD_(VOID, KsSetAllocatorMode)(
        THIS_
        KSALLOCATORMODE Mode
    ) PURE;
};

interface DECLSPEC_UUID("091bb63a-603f-11d1-b067-00a0c9062802") IKsAllocatorEx;
#undef INTERFACE
#define INTERFACE IKsAllocatorEx
DECLARE_INTERFACE_(IKsAllocatorEx, IKsAllocator)
{
    STDMETHOD_(PALLOCATOR_PROPERTIES_EX, KsGetProperties)(
        THIS
    ) PURE;
    STDMETHOD_(VOID, KsSetProperties)(
        THIS_
        PALLOCATOR_PROPERTIES_EX 
    ) PURE;
    STDMETHOD_(VOID, KsSetAllocatorHandle)(
        THIS_
        HANDLE AllocatorHandle
    ) PURE;
    STDMETHOD_(HANDLE, KsCreateAllocatorAndGetHandle)(
        THIS_
        IKsPin*   KsPin
    ) PURE;
};  

typedef enum {
    KsPeekOperation_PeekOnly,
    KsPeekOperation_AddRef
} KSPEEKOPERATION;

typedef struct _KSSTREAM_SEGMENT *PKSSTREAM_SEGMENT;

interface DECLSPEC_UUID("b61178d1-a2d9-11cf-9e53-00aa00a216a1") IKsPin;

#undef INTERFACE
#define INTERFACE IKsPin
DECLARE_INTERFACE_(IKsPin, IUnknown)
{
    STDMETHOD(KsQueryMediums)(
        THIS_
        PKSMULTIPLE_ITEM* MediumList
    ) PURE;
    STDMETHOD(KsQueryInterfaces)(
        THIS_
        PKSMULTIPLE_ITEM* InterfaceList
    ) PURE;
    STDMETHOD(KsCreateSinkPinHandle)(
        THIS_
        KSPIN_INTERFACE& Interface,
        KSPIN_MEDIUM& Medium
    ) PURE;
    STDMETHOD(KsGetCurrentCommunication)(
        THIS_
        KSPIN_COMMUNICATION *Communication,
        KSPIN_INTERFACE *Interface,
        KSPIN_MEDIUM *Medium
    ) PURE;
    STDMETHOD(KsPropagateAcquire)(
        THIS
    ) PURE;
    STDMETHOD(KsDeliver)(
        THIS_
        IMediaSample* Sample,
        ULONG Flags
    ) PURE;
    STDMETHOD(KsMediaSamplesCompleted)(
        THIS_
        PKSSTREAM_SEGMENT StreamSegment
    ) PURE;
    STDMETHOD_(IMemAllocator *, KsPeekAllocator)(
        THIS_
        KSPEEKOPERATION Operation
    ) PURE;
    STDMETHOD(KsReceiveAllocator)(
        THIS_
        IMemAllocator *MemAllocator
    ) PURE;
    STDMETHOD(KsRenegotiateAllocator)(
        THIS
    ) PURE;
    STDMETHOD_(LONG, KsIncrementPendingIoCount)(
        THIS
    ) PURE;
    STDMETHOD_(LONG, KsDecrementPendingIoCount)(
        THIS
    ) PURE;
    STDMETHOD(KsQualityNotify)(
        THIS_
        ULONG Proportion,
        REFERENCE_TIME TimeDelta
    ) PURE;
};

interface DECLSPEC_UUID("7bb38260-d19c-11d2-b38a-00a0c95ec22e") IKsPinEx;
#undef INTERFACE
#define INTERFACE IKsPinEx
DECLARE_INTERFACE_(IKsPinEx, IKsPin)
{
    STDMETHOD_(VOID, KsNotifyError)(
        THIS_
        IMediaSample* Sample,
        HRESULT hr
    ) PURE;        
};
                         
interface DECLSPEC_UUID("e539cd90-a8b4-11d1-8189-00a0c9062802") IKsPinPipe;
#undef INTERFACE
#define INTERFACE IKsPinPipe
DECLARE_INTERFACE_(IKsPinPipe, IUnknown)
{
    STDMETHOD(KsGetPinFramingCache)(
        THIS_
        PKSALLOCATOR_FRAMING_EX *FramingEx,
        PFRAMING_PROP FramingProp,
        FRAMING_CACHE_OPS Option
    ) PURE;
    STDMETHOD(KsSetPinFramingCache)(
        THIS_
        PKSALLOCATOR_FRAMING_EX FramingEx,
        PFRAMING_PROP FramingProp,
        FRAMING_CACHE_OPS Option
    ) PURE;
    STDMETHOD_(IPin*, KsGetConnectedPin)(
        THIS
    ) PURE;
    STDMETHOD_(IKsAllocatorEx*, KsGetPipe)(
        THIS_
        KSPEEKOPERATION Operation
    ) PURE;
    STDMETHOD(KsSetPipe)(
        THIS_
        IKsAllocatorEx *KsAllocator
    ) PURE;
    STDMETHOD_(ULONG, KsGetPipeAllocatorFlag)(
        THIS
    ) PURE;
    STDMETHOD(KsSetPipeAllocatorFlag)(
        THIS_
        ULONG Flag
    ) PURE;
    STDMETHOD_(GUID, KsGetPinBusCache)(
        THIS
    ) PURE;
    STDMETHOD(KsSetPinBusCache)(
        THIS_
        GUID Bus
    ) PURE;
//
// very useful methods for tracing.
//
    STDMETHOD_(PWCHAR, KsGetPinName)(
        THIS
    ) PURE;
    STDMETHOD_(PWCHAR, KsGetFilterName)(
        THIS
    ) PURE;
};


interface DECLSPEC_UUID("CD5EBE6B-8B6E-11D1-8AE0-00A0C9223196") IKsPinFactory;
#undef INTERFACE
#define INTERFACE IKsPinFactory
DECLARE_INTERFACE_(IKsPinFactory, IUnknown)
{
    STDMETHOD(KsPinFactory)(
        THIS_
        ULONG* PinFactory
    ) PURE;
};

typedef enum {
    KsIoOperation_Write,
    KsIoOperation_Read
} KSIOOPERATION;

interface DECLSPEC_UUID("5ffbaa02-49a3-11d0-9f36-00aa00a216a1") IKsDataTypeHandler;
#undef INTERFACE
#define INTERFACE IKsDataTypeHandler
DECLARE_INTERFACE_(IKsDataTypeHandler, IUnknown)
{
    STDMETHOD(KsCompleteIoOperation)(
        THIS_
        IMediaSample *Sample,
        PVOID StreamHeader,
        KSIOOPERATION IoOperation,
        BOOL Cancelled
    ) PURE;
    STDMETHOD(KsIsMediaTypeInRanges)(
        THIS_
        PVOID DataRanges
        ) PURE;
    STDMETHOD(KsPrepareIoOperation)(
        THIS_
        IMediaSample *Sample,
        PVOID StreamHeader,
        KSIOOPERATION IoOperation
    ) PURE;
    STDMETHOD(KsQueryExtendedSize)(
        THIS_
        ULONG* ExtendedSize
    ) PURE;
    STDMETHOD(KsSetMediaType)(
        THIS_
        const AM_MEDIA_TYPE* AmMediaType
    ) PURE;
};

interface DECLSPEC_UUID("827D1A0E-0F73-11D2-B27A-00A0C9223196") IKsDataTypeCompletion;
#undef INTERFACE
#define INTERFACE IKsDataTypeCompletion
DECLARE_INTERFACE_(IKsDataTypeCompletion, IUnknown)
{
    STDMETHOD(KsCompleteMediaType)(
        THIS_
        HANDLE FilterHandle,
        ULONG PinFactoryId,
        AM_MEDIA_TYPE* AmMediaType
    ) PURE;
};

interface DECLSPEC_UUID("D3ABC7E0-9A61-11d0-A40D-00A0C9223196") IKsInterfaceHandler;
#undef INTERFACE
#define INTERFACE IKsInterfaceHandler
DECLARE_INTERFACE_(IKsInterfaceHandler, IUnknown)
{
    STDMETHOD(KsSetPin)(
        THIS_
        IKsPin *KsPin
    ) PURE;
    STDMETHOD(KsProcessMediaSamples)(
        THIS_
        IKsDataTypeHandler *KsDataTypeHandler,
        IMediaSample** SampleList,
        PLONG SampleCount,
        KSIOOPERATION IoOperation,
        PKSSTREAM_SEGMENT *StreamSegment
    ) PURE;
    STDMETHOD(KsCompleteIo)(
        THIS_
        PKSSTREAM_SEGMENT StreamSegment
    ) PURE;
};


//
// This structure definition is the common header required by the proxy to 
// dispatch the stream segment to the interface handler.  Interface handlers 
// will create extended structures to include other information such as 
// media samples, extended header size and so on.
//

typedef struct _KSSTREAM_SEGMENT {
    IKsInterfaceHandler     *KsInterfaceHandler;
    IKsDataTypeHandler      *KsDataTypeHandler;
    KSIOOPERATION           IoOperation;
    HANDLE                  CompletionEvent;
    
} KSSTREAM_SEGMENT;

interface DECLSPEC_UUID("423c13a2-2070-11d0-9ef7-00aa00a216a1") IKsObject;
#undef INTERFACE
#define INTERFACE IKsObject
DECLARE_INTERFACE_(IKsObject, IUnknown)
{
    STDMETHOD_(HANDLE, KsGetObjectHandle)(
        THIS
    ) PURE;
};

interface DECLSPEC_UUID("97ebaacb-95bd-11d0-a3ea-00a0c9223196") IKsQualityForwarder;
#undef INTERFACE
#define INTERFACE IKsQualityForwarder
DECLARE_INTERFACE_(IKsQualityForwarder, IKsObject)
{
    STDMETHOD_(VOID, KsFlushClient)(
        THIS_
        IKsPin* Pin
    ) PURE;
};

KSDDKAPI
HRESULT
WINAPI
KsResolveRequiredAttributes(
    PKSDATARANGE DataRange,
    PKSMULTIPLE_ITEM Attributes OPTIONAL
    );

KSDDKAPI
HRESULT
WINAPI
KsOpenDefaultDevice(
    REFGUID Category,
    ACCESS_MASK Access,
    PHANDLE DeviceHandle
    );
KSDDKAPI
HRESULT
WINAPI
KsSynchronousDeviceControl(
    HANDLE      Handle,
    ULONG       IoControl,
    PVOID       InBuffer,
    ULONG       InLength,
    PVOID       OutBuffer,
    ULONG       OutLength,
    PULONG      BytesReturned
    );
KSDDKAPI
HRESULT
WINAPI
KsGetMultiplePinFactoryItems(
    HANDLE  FilterHandle,
    ULONG   PinFactoryId,
    ULONG   PropertyId,
    PVOID*  Items
    );
KSDDKAPI
HRESULT
WINAPI
KsGetMediaTypeCount(
    HANDLE      FilterHandle,
    ULONG       PinFactoryId,
    ULONG*      MediaTypeCount
    );
KSDDKAPI
HRESULT
WINAPI
KsGetMediaType(
    int         Position,
    AM_MEDIA_TYPE* AmMediaType,
    HANDLE      FilterHandle,
    ULONG       PinFactoryId
    );

#endif // __STREAMS__

#ifndef _IKsPropertySet_
#if !defined(__cplusplus) || _MSC_VER < 1100
DEFINE_GUIDEX(IID_IKsPropertySet);
#endif // !defined(__cplusplus) || _MSC_VER < 1100
#endif // _IKsPropertySet_

#ifndef _IKsControl_
#if !defined(__cplusplus) || _MSC_VER < 1100
DEFINE_GUIDEX(IID_IKsControl);
#endif // !defined(__cplusplus) || _MSC_VER < 1100
#endif // _IKsControl_

#if !defined(__cplusplus) || _MSC_VER < 1100
DEFINE_GUIDEX(IID_IKsAggregateControl);
#endif // !defined(__cplusplus) || _MSC_VER < 1100

#ifndef _IKsTopology_
#if !defined(__cplusplus) || _MSC_VER < 1100
DEFINE_GUIDEX(IID_IKsTopology);
#endif // !defined(__cplusplus) || _MSC_VER < 1100
#endif // _IKsTopology_

DEFINE_GUIDSTRUCT("17CCA71B-ECD7-11D0-B908-00A0C9223196", CLSID_Proxy);
#define CLSID_Proxy DEFINE_GUIDNAMED(CLSID_Proxy)

#else // !_KS_

#ifndef _IKsPropertySet_
#if !defined(__cplusplus) || _MSC_VER < 1100
DEFINE_GUID(IID_IKsPropertySet, STATIC_IID_IKsPropertySet);
#endif // !defined(__cplusplus) || _MSC_VER < 1100
#endif // _IKsPropertySet_

#if !defined(__cplusplus) || _MSC_VER < 1100
DEFINE_GUID(CLSID_Proxy, STATIC_CLSID_Proxy);
#else  // defined(__cplusplus) && _MSC_VER >= 1100
DECLSPEC_UUID("17CCA71B-ECD7-11D0-B908-00A0C9223196") CLSID_Proxy;
#endif  // defined(__cplusplus) && _MSC_VER >= 1100

#endif // !_KS_

#ifndef _IKsPropertySet_
#define _IKsPropertySet_

#define KSPROPERTY_SUPPORT_GET 1
#define KSPROPERTY_SUPPORT_SET 2

#ifdef DECLARE_INTERFACE_

interface DECLSPEC_UUID("31EFAC30-515C-11d0-A9AA-00aa0061be93") IKsPropertySet;
#undef INTERFACE
#define INTERFACE IKsPropertySet
DECLARE_INTERFACE_(IKsPropertySet, IUnknown)
{
    STDMETHOD(Set)(
        THIS_
        IN REFGUID PropSet,
        IN ULONG Id,
        IN LPVOID InstanceData,
        IN ULONG InstanceLength,
        IN LPVOID PropertyData,
        IN ULONG DataLength
    ) PURE;

    STDMETHOD(Get)(
        THIS_
        IN REFGUID PropSet,
        IN ULONG Id,
        IN LPVOID InstanceData,
        IN ULONG InstanceLength,
        OUT LPVOID PropertyData,
        IN ULONG DataLength,
        OUT ULONG* BytesReturned
    ) PURE;

    STDMETHOD(QuerySupported)(
        THIS_
        IN REFGUID PropSet,
        IN ULONG Id,
        OUT ULONG* TypeSupport
    ) PURE;
};

#endif // DECLARE_INTERFACE_

#endif // _IKsPropertySet_

#ifndef _IKsControl_
#define _IKsControl_

#ifdef DECLARE_INTERFACE_

interface DECLSPEC_UUID("28F54685-06FD-11D2-B27A-00A0C9223196") IKsControl;
#undef INTERFACE
#define INTERFACE IKsControl
DECLARE_INTERFACE_(IKsControl, IUnknown)
{
    STDMETHOD(KsProperty)(
        THIS_
        IN PKSPROPERTY Property,
        IN ULONG PropertyLength,
        IN OUT LPVOID PropertyData,
        IN ULONG DataLength,
        OUT ULONG* BytesReturned
    ) PURE;
    STDMETHOD(KsMethod)(
        THIS_
        IN PKSMETHOD Method,
        IN ULONG MethodLength,
        IN OUT LPVOID MethodData,
        IN ULONG DataLength,
        OUT ULONG* BytesReturned
    ) PURE;
    STDMETHOD(KsEvent)(
        THIS_
        IN PKSEVENT Event OPTIONAL,
        IN ULONG EventLength,
        IN OUT LPVOID EventData,
        IN ULONG DataLength,
        OUT ULONG* BytesReturned
    ) PURE;
};

#endif // DECLARE_INTERFACE_

#endif // _IKsControl_


#ifdef DECLARE_INTERFACE_

interface DECLSPEC_UUID("7F40EAC0-3947-11D2-874E-00A0C9223196") IKsAggregateControl;
#undef INTERFACE
#define INTERFACE IKsAggregateControl
DECLARE_INTERFACE_(IKsAggregateControl, IUnknown)
{
    STDMETHOD(KsAddAggregate)(
        THIS_
        IN REFGUID AggregateClass
    ) PURE;
    STDMETHOD(KsRemoveAggregate)(
        THIS_
        IN REFGUID AggregateClass
    ) PURE;
};

#endif // DECLARE_INTERFACE_

#ifndef _IKsTopology_
#define _IKsTopology_

#ifdef DECLARE_INTERFACE_

interface DECLSPEC_UUID("28F54683-06FD-11D2-B27A-00A0C9223196") IKsTopology;
#undef INTERFACE
#define INTERFACE IKsTopology
DECLARE_INTERFACE_(IKsTopology, IUnknown)
{
    STDMETHOD(CreateNodeInstance)(
        THIS_
        IN ULONG NodeId,
        IN ULONG Flags,
        IN ACCESS_MASK DesiredAccess,
        IN IUnknown* UnkOuter OPTIONAL,
        IN REFGUID InterfaceId,
        OUT LPVOID* Interface
    ) PURE;
};

#endif // DECLARE_INTERFACE_

#endif // _IKsTopology_

#ifdef __cplusplus
}
#endif // __cplusplus

#endif // __KSPROXY__
1	bearsoft	1.1	/*++
2
3			Copyright (C) Microsoft Corporation, 1996 - 1999
4
5			Module Name:
6
7			ksproxy.h
8
9			Abstract:
10
11			Interface definitions for WDM-CSA proxy filters.
12
13			--*/
14
15			#ifndef __KSPROXY__
16			#define __KSPROXY__
17
18			#ifdef __cplusplus
19			extern "C" {
20			#endif
21
22			#undef KSDDKAPI
23			#ifdef _KSDDK_
24			#define KSDDKAPI
25			#else // !_KSDDK_
26			#define KSDDKAPI DECLSPEC_IMPORT
27			#endif // _KSDDK_
28
29			#define STATIC_IID_IKsObject\
30			0x423c13a2L, 0x2070, 0x11d0, 0x9e, 0xf7, 0x00, 0xaa, 0x00, 0xa2, 0x16, 0xa1
31
32			#define STATIC_IID_IKsPinEx\
33			0x7bb38260L, 0xd19c, 0x11d2, 0xb3, 0x8a, 0x00, 0xa0, 0xc9, 0x5e, 0xc2, 0x2e
34
35			#define STATIC_IID_IKsPin\
36			0xb61178d1L, 0xa2d9, 0x11cf, 0x9e, 0x53, 0x00, 0xaa, 0x00, 0xa2, 0x16, 0xa1
37
38			#define STATIC_IID_IKsPinPipe\
39			0xe539cd90L, 0xa8b4, 0x11d1, 0x81, 0x89, 0x00, 0xa0, 0xc9, 0x06, 0x28, 0x02
40
41			#define STATIC_IID_IKsDataTypeHandler\
42			0x5ffbaa02L, 0x49a3, 0x11d0, 0x9f, 0x36, 0x00, 0xaa, 0x00, 0xa2, 0x16, 0xa1
43
44			#define STATIC_IID_IKsDataTypeCompletion\
45			0x827D1A0EL, 0x0F73, 0x11D2, 0xB2, 0x7A, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96
46
47			#define STATIC_IID_IKsInterfaceHandler\
48			0xD3ABC7E0L, 0x9A61, 0x11D0, 0xA4, 0x0D, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96
49
50			#define STATIC_IID_IKsClockPropertySet\
51			0x5C5CBD84L, 0xE755, 0x11D0, 0xAC, 0x18, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96
52
53			#define STATIC_IID_IKsAllocator\
54			0x8da64899L, 0xc0d9, 0x11d0, 0x84, 0x13, 0x00, 0x00, 0xf8, 0x22, 0xfe, 0x8a
55
56			#define STATIC_IID_IKsAllocatorEx\
57			0x091bb63aL, 0x603f, 0x11d1, 0xb0, 0x67, 0x00, 0xa0, 0xc9, 0x06, 0x28, 0x02
58
59
60			#ifndef STATIC_IID_IKsPropertySet
61			#define STATIC_IID_IKsPropertySet\
62			0x31EFAC30L, 0x515C, 0x11d0, 0xA9, 0xAA, 0x00, 0xAA, 0x00, 0x61, 0xBE, 0x93
63			#endif // STATIC_IID_IKsPropertySet
64
65			#define STATIC_IID_IKsTopology\
66			0x28F54683L, 0x06FD, 0x11D2, 0xB2, 0x7A, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96
67
68			#ifndef STATIC_IID_IKsControl
69			#define STATIC_IID_IKsControl\
70			0x28F54685L, 0x06FD, 0x11D2, 0xB2, 0x7A, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96
71			#endif // STATIC_IID_IKsControl
72
73			#define STATIC_IID_IKsAggregateControl\
74			0x7F40EAC0L, 0x3947, 0x11D2, 0x87, 0x4E, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96
75
76			#define STATIC_CLSID_Proxy \
77			0x17CCA71BL, 0xECD7, 0x11D0, 0xB9, 0x08, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96
78
79			#ifdef _KS_
80
81			#if !defined(__cplusplus) \|\| _MSC_VER < 1100
82			DEFINE_GUIDEX(IID_IKsObject);
83
84			DEFINE_GUIDEX(IID_IKsPin);
85
86			DEFINE_GUIDEX(IID_IKsPinEx);
87
88			DEFINE_GUIDEX(IID_IKsPinPipe);
89
90			DEFINE_GUIDEX(IID_IKsDataTypeHandler);
91
92			DEFINE_GUIDEX(IID_IKsDataTypeCompletion);
93
94			DEFINE_GUIDEX(IID_IKsInterfaceHandler);
95
96			DEFINE_GUIDEX(IID_IKsClockPropertySet);
97
98			DEFINE_GUIDEX(IID_IKsAllocator);
99
100			DEFINE_GUIDEX(IID_IKsAllocatorEx);
101
102			#define IID_IKsQualityForwarder KSCATEGORY_QUALITY
103			#endif // !defined(__cplusplus) \|\| _MSC_VER < 1100
104
105			#define STATIC_IID_IKsQualityForwarder STATIC_KSCATEGORY_QUALITY
106
107			typedef enum {
108			KsAllocatorMode_User,
109			KsAllocatorMode_Kernel
110			} KSALLOCATORMODE;
111
112
113			typedef enum {
114			FramingProp_Uninitialized,
115			FramingProp_None,
116			FramingProp_Old,
117			FramingProp_Ex
118			} FRAMING_PROP;
119
120			typedef FRAMING_PROP *PFRAMING_PROP;
121
122
123			typedef enum {
124			Framing_Cache_Update, // request to bypass cache when read/write
125			Framing_Cache_ReadLast,
126			Framing_Cache_ReadOrig,
127			Framing_Cache_Write
128			} FRAMING_CACHE_OPS;
129
130
131			typedef struct {
132			LONGLONG MinTotalNominator;
133			LONGLONG MaxTotalNominator;
134			LONGLONG TotalDenominator;
135			} OPTIMAL_WEIGHT_TOTALS;
136
137			// forward declaration
138			typedef struct IPin IPin;
139			typedef struct IKsPin IKsPin;
140			typedef struct IKsAllocator IKsAllocator;
141			typedef struct IKsAllocatorEx IKsAllocatorEx;
142
143
144			//
145			// allocators strategy is defined by graph manager
146			//
147			#define AllocatorStrategy_DontCare 0
148
149			//
150			// what to optimize
151			//
152			#define AllocatorStrategy_MinimizeNumberOfFrames 0x00000001
153			#define AllocatorStrategy_MinimizeFrameSize 0x00000002
154			#define AllocatorStrategy_MinimizeNumberOfAllocators 0x00000004
155			#define AllocatorStrategy_MaximizeSpeed 0x00000008
156
157			//
158			// factors (flags) defining the Pipes properties
159			//
160			#define PipeFactor_None 0
161			#define PipeFactor_UserModeUpstream 0x00000001
162			#define PipeFactor_UserModeDownstream 0x00000002
163			#define PipeFactor_MemoryTypes 0x00000004
164			#define PipeFactor_Flags 0x00000008
165			#define PipeFactor_PhysicalRanges 0x00000010
166			#define PipeFactor_OptimalRanges 0x00000020
167			#define PipeFactor_FixedCompression 0x00000040
168			#define PipeFactor_UnknownCompression 0x00000080
169
170			#define PipeFactor_Buffers 0x00000100
171			#define PipeFactor_Align 0x00000200
172
173			#define PipeFactor_PhysicalEnd 0x00000400
174			#define PipeFactor_LogicalEnd 0x00000800
175
176
177
178			typedef enum {
179			PipeState_DontCare,
180			PipeState_RangeNotFixed,
181			PipeState_RangeFixed,
182			PipeState_CompressionUnknown,
183			PipeState_Finalized
184			} PIPE_STATE;
185
186
187			//
188			// pipe dimensions relative to BeginPin.
189			//
190
191			typedef struct _PIPE_DIMENSIONS {
192			KS_COMPRESSION AllocatorPin;
193			KS_COMPRESSION MaxExpansionPin;
194			KS_COMPRESSION EndPin;
195			} PIPE_DIMENSIONS, *PPIPE_DIMENSIONS;
196
197
198			typedef enum {
199			Pipe_Allocator_None,
200			Pipe_Allocator_FirstPin,
201			Pipe_Allocator_LastPin,
202			Pipe_Allocator_MiddlePin
203			} PIPE_ALLOCATOR_PLACE;
204
205			typedef PIPE_ALLOCATOR_PLACE *PPIPE_ALLOCATOR_PLACE;
206
207
208			typedef enum {
209			KS_MemoryTypeDontCare = 0,
210			KS_MemoryTypeKernelPaged,
211			KS_MemoryTypeKernelNonPaged,
212			KS_MemoryTypeDeviceHostMapped,
213			KS_MemoryTypeDeviceSpecific,
214			KS_MemoryTypeUser,
215			KS_MemoryTypeAnyHost
216			} KS_LogicalMemoryType;
217
218			typedef KS_LogicalMemoryType *PKS_LogicalMemoryType;
219
220
221
222			typedef struct _PIPE_TERMINATION {
223			ULONG Flags;
224			ULONG OutsideFactors;
225			ULONG Weigth; // outside weight
226			KS_FRAMING_RANGE PhysicalRange;
227			KS_FRAMING_RANGE_WEIGHTED OptimalRange;
228			KS_COMPRESSION Compression; // relative to the connected pin on a neighboring filter.
229			} PIPE_TERMINATION;
230
231
232			//
233			// extended allocator properties
234			//
235			typedef struct _ALLOCATOR_PROPERTIES_EX
236			{
237			long cBuffers;
238			long cbBuffer;
239			long cbAlign;
240			long cbPrefix;
241			// new part
242			GUID MemoryType;
243			GUID BusType; // one of the buses this pipe is using
244			PIPE_STATE State;
245			PIPE_TERMINATION Input;
246			PIPE_TERMINATION Output;
247			ULONG Strategy;
248			ULONG Flags;
249			ULONG Weight;
250			KS_LogicalMemoryType LogicalMemoryType;
251			PIPE_ALLOCATOR_PLACE AllocatorPlace;
252			PIPE_DIMENSIONS Dimensions;
253			KS_FRAMING_RANGE PhysicalRange; // on allocator pin
254			IKsAllocatorEx* PrevSegment; // doubly-linked list of KS allocators
255			ULONG CountNextSegments; // possible multiple dependent pipes
256			IKsAllocatorEx** NextSegments;
257			ULONG InsideFactors; // existing factors (different from "don't care")
258			ULONG NumberPins;
259			} ALLOCATOR_PROPERTIES_EX;
260
261			typedef ALLOCATOR_PROPERTIES_EX *PALLOCATOR_PROPERTIES_EX;
262
263
264			#ifdef __STREAMS__
265
266			struct DECLSPEC_UUID("5C5CBD84-E755-11D0-AC18-00A0C9223196") IKsClockPropertySet;
267			#undef INTERFACE
268			#define INTERFACE IKsClockPropertySet
269			DECLARE_INTERFACE_(IKsClockPropertySet, IUnknown)
270			{
271			STDMETHOD(KsGetTime)(
272			THIS_
273			LONGLONG* Time
274			) PURE;
275			STDMETHOD(KsSetTime)(
276			THIS_
277			LONGLONG Time
278			) PURE;
279			STDMETHOD(KsGetPhysicalTime)(
280			THIS_
281			LONGLONG* Time
282			) PURE;
283			STDMETHOD(KsSetPhysicalTime)(
284			THIS_
285			LONGLONG Time
286			) PURE;
287			STDMETHOD(KsGetCorrelatedTime)(
288			THIS_
289			KSCORRELATED_TIME* CorrelatedTime
290			) PURE;
291			STDMETHOD(KsSetCorrelatedTime)(
292			THIS_
293			KSCORRELATED_TIME* CorrelatedTime
294			) PURE;
295			STDMETHOD(KsGetCorrelatedPhysicalTime)(
296			THIS_
297			KSCORRELATED_TIME* CorrelatedTime
298			) PURE;
299			STDMETHOD(KsSetCorrelatedPhysicalTime)(
300			THIS_
301			KSCORRELATED_TIME* CorrelatedTime
302			) PURE;
303			STDMETHOD(KsGetResolution)(
304			THIS_
305			KSRESOLUTION* Resolution
306			) PURE;
307			STDMETHOD(KsGetState)(
308			THIS_
309			KSSTATE* State
310			) PURE;
311			};
312
313
314			interface DECLSPEC_UUID("8da64899-c0d9-11d0-8413-0000f822fe8a") IKsAllocator;
315			#undef INTERFACE
316			#define INTERFACE IKsAllocator
317			DECLARE_INTERFACE_(IKsAllocator, IUnknown)
318			{
319			STDMETHOD_(HANDLE, KsGetAllocatorHandle)(
320			THIS
321			) PURE;
322			STDMETHOD_(KSALLOCATORMODE, KsGetAllocatorMode)(
323			THIS
324			) PURE;
325			STDMETHOD(KsGetAllocatorStatus)(
326			THIS_
327			PKSSTREAMALLOCATOR_STATUS AllocatorStatus
328			) PURE;
329			STDMETHOD_(VOID, KsSetAllocatorMode)(
330			THIS_
331			KSALLOCATORMODE Mode
332			) PURE;
333			};
334
335			interface DECLSPEC_UUID("091bb63a-603f-11d1-b067-00a0c9062802") IKsAllocatorEx;
336			#undef INTERFACE
337			#define INTERFACE IKsAllocatorEx
338			DECLARE_INTERFACE_(IKsAllocatorEx, IKsAllocator)
339			{
340			STDMETHOD_(PALLOCATOR_PROPERTIES_EX, KsGetProperties)(
341			THIS
342			) PURE;
343			STDMETHOD_(VOID, KsSetProperties)(
344			THIS_
345			PALLOCATOR_PROPERTIES_EX
346			) PURE;
347			STDMETHOD_(VOID, KsSetAllocatorHandle)(
348			THIS_
349			HANDLE AllocatorHandle
350			) PURE;
351			STDMETHOD_(HANDLE, KsCreateAllocatorAndGetHandle)(
352			THIS_
353			IKsPin* KsPin
354			) PURE;
355			};
356
357			typedef enum {
358			KsPeekOperation_PeekOnly,
359			KsPeekOperation_AddRef
360			} KSPEEKOPERATION;
361
362			typedef struct _KSSTREAM_SEGMENT *PKSSTREAM_SEGMENT;
363
364			interface DECLSPEC_UUID("b61178d1-a2d9-11cf-9e53-00aa00a216a1") IKsPin;
365
366			#undef INTERFACE
367			#define INTERFACE IKsPin
368			DECLARE_INTERFACE_(IKsPin, IUnknown)
369			{
370			STDMETHOD(KsQueryMediums)(
371			THIS_
372			PKSMULTIPLE_ITEM* MediumList
373			) PURE;
374			STDMETHOD(KsQueryInterfaces)(
375			THIS_
376			PKSMULTIPLE_ITEM* InterfaceList
377			) PURE;
378			STDMETHOD(KsCreateSinkPinHandle)(
379			THIS_
380			KSPIN_INTERFACE& Interface,
381			KSPIN_MEDIUM& Medium
382			) PURE;
383			STDMETHOD(KsGetCurrentCommunication)(
384			THIS_
385			KSPIN_COMMUNICATION *Communication,
386			KSPIN_INTERFACE *Interface,
387			KSPIN_MEDIUM *Medium
388			) PURE;
389			STDMETHOD(KsPropagateAcquire)(
390			THIS
391			) PURE;
392			STDMETHOD(KsDeliver)(
393			THIS_
394			IMediaSample* Sample,
395			ULONG Flags
396			) PURE;
397			STDMETHOD(KsMediaSamplesCompleted)(
398			THIS_
399			PKSSTREAM_SEGMENT StreamSegment
400			) PURE;
401			STDMETHOD_(IMemAllocator *, KsPeekAllocator)(
402			THIS_
403			KSPEEKOPERATION Operation
404			) PURE;
405			STDMETHOD(KsReceiveAllocator)(
406			THIS_
407			IMemAllocator *MemAllocator
408			) PURE;
409			STDMETHOD(KsRenegotiateAllocator)(
410			THIS
411			) PURE;
412			STDMETHOD_(LONG, KsIncrementPendingIoCount)(
413			THIS
414			) PURE;
415			STDMETHOD_(LONG, KsDecrementPendingIoCount)(
416			THIS
417			) PURE;
418			STDMETHOD(KsQualityNotify)(
419			THIS_
420			ULONG Proportion,
421			REFERENCE_TIME TimeDelta
422			) PURE;
423			};
424
425			interface DECLSPEC_UUID("7bb38260-d19c-11d2-b38a-00a0c95ec22e") IKsPinEx;
426			#undef INTERFACE
427			#define INTERFACE IKsPinEx
428			DECLARE_INTERFACE_(IKsPinEx, IKsPin)
429			{
430			STDMETHOD_(VOID, KsNotifyError)(
431			THIS_
432			IMediaSample* Sample,
433			HRESULT hr
434			) PURE;
435			};
436
437			interface DECLSPEC_UUID("e539cd90-a8b4-11d1-8189-00a0c9062802") IKsPinPipe;
438			#undef INTERFACE
439			#define INTERFACE IKsPinPipe
440			DECLARE_INTERFACE_(IKsPinPipe, IUnknown)
441			{
442			STDMETHOD(KsGetPinFramingCache)(
443			THIS_
444			PKSALLOCATOR_FRAMING_EX *FramingEx,
445			PFRAMING_PROP FramingProp,
446			FRAMING_CACHE_OPS Option
447			) PURE;
448			STDMETHOD(KsSetPinFramingCache)(
449			THIS_
450			PKSALLOCATOR_FRAMING_EX FramingEx,
451			PFRAMING_PROP FramingProp,
452			FRAMING_CACHE_OPS Option
453			) PURE;
454			STDMETHOD_(IPin*, KsGetConnectedPin)(
455			THIS
456			) PURE;
457			STDMETHOD_(IKsAllocatorEx*, KsGetPipe)(
458			THIS_
459			KSPEEKOPERATION Operation
460			) PURE;
461			STDMETHOD(KsSetPipe)(
462			THIS_
463			IKsAllocatorEx *KsAllocator
464			) PURE;
465			STDMETHOD_(ULONG, KsGetPipeAllocatorFlag)(
466			THIS
467			) PURE;
468			STDMETHOD(KsSetPipeAllocatorFlag)(
469			THIS_
470			ULONG Flag
471			) PURE;
472			STDMETHOD_(GUID, KsGetPinBusCache)(
473			THIS
474			) PURE;
475			STDMETHOD(KsSetPinBusCache)(
476			THIS_
477			GUID Bus
478			) PURE;
479			//
480			// very useful methods for tracing.
481			//
482			STDMETHOD_(PWCHAR, KsGetPinName)(
483			THIS
484			) PURE;
485			STDMETHOD_(PWCHAR, KsGetFilterName)(
486			THIS
487			) PURE;
488			};
489
490
491			interface DECLSPEC_UUID("CD5EBE6B-8B6E-11D1-8AE0-00A0C9223196") IKsPinFactory;
492			#undef INTERFACE
493			#define INTERFACE IKsPinFactory
494			DECLARE_INTERFACE_(IKsPinFactory, IUnknown)
495			{
496			STDMETHOD(KsPinFactory)(
497			THIS_
498			ULONG* PinFactory
499			) PURE;
500			};
501
502			typedef enum {
503			KsIoOperation_Write,
504			KsIoOperation_Read
505			} KSIOOPERATION;
506
507			interface DECLSPEC_UUID("5ffbaa02-49a3-11d0-9f36-00aa00a216a1") IKsDataTypeHandler;
508			#undef INTERFACE
509			#define INTERFACE IKsDataTypeHandler
510			DECLARE_INTERFACE_(IKsDataTypeHandler, IUnknown)
511			{
512			STDMETHOD(KsCompleteIoOperation)(
513			THIS_
514			IMediaSample *Sample,
515			PVOID StreamHeader,
516			KSIOOPERATION IoOperation,
517			BOOL Cancelled
518			) PURE;
519			STDMETHOD(KsIsMediaTypeInRanges)(
520			THIS_
521			PVOID DataRanges
522			) PURE;
523			STDMETHOD(KsPrepareIoOperation)(
524			THIS_
525			IMediaSample *Sample,
526			PVOID StreamHeader,
527			KSIOOPERATION IoOperation
528			) PURE;
529			STDMETHOD(KsQueryExtendedSize)(
530			THIS_
531			ULONG* ExtendedSize
532			) PURE;
533			STDMETHOD(KsSetMediaType)(
534			THIS_
535			const AM_MEDIA_TYPE* AmMediaType
536			) PURE;
537			};
538
539			interface DECLSPEC_UUID("827D1A0E-0F73-11D2-B27A-00A0C9223196") IKsDataTypeCompletion;
540			#undef INTERFACE
541			#define INTERFACE IKsDataTypeCompletion
542			DECLARE_INTERFACE_(IKsDataTypeCompletion, IUnknown)
543			{
544			STDMETHOD(KsCompleteMediaType)(
545			THIS_
546			HANDLE FilterHandle,
547			ULONG PinFactoryId,
548			AM_MEDIA_TYPE* AmMediaType
549			) PURE;
550			};
551
552			interface DECLSPEC_UUID("D3ABC7E0-9A61-11d0-A40D-00A0C9223196") IKsInterfaceHandler;
553			#undef INTERFACE
554			#define INTERFACE IKsInterfaceHandler
555			DECLARE_INTERFACE_(IKsInterfaceHandler, IUnknown)
556			{
557			STDMETHOD(KsSetPin)(
558			THIS_
559			IKsPin *KsPin
560			) PURE;
561			STDMETHOD(KsProcessMediaSamples)(
562			THIS_
563			IKsDataTypeHandler *KsDataTypeHandler,
564			IMediaSample** SampleList,
565			PLONG SampleCount,
566			KSIOOPERATION IoOperation,
567			PKSSTREAM_SEGMENT *StreamSegment
568			) PURE;
569			STDMETHOD(KsCompleteIo)(
570			THIS_
571			PKSSTREAM_SEGMENT StreamSegment
572			) PURE;
573			};
574
575
576			//
577			// This structure definition is the common header required by the proxy to
578			// dispatch the stream segment to the interface handler. Interface handlers
579			// will create extended structures to include other information such as
580			// media samples, extended header size and so on.
581			//
582
583			typedef struct _KSSTREAM_SEGMENT {
584			IKsInterfaceHandler *KsInterfaceHandler;
585			IKsDataTypeHandler *KsDataTypeHandler;
586			KSIOOPERATION IoOperation;
587			HANDLE CompletionEvent;
588
589			} KSSTREAM_SEGMENT;
590
591			interface DECLSPEC_UUID("423c13a2-2070-11d0-9ef7-00aa00a216a1") IKsObject;
592			#undef INTERFACE
593			#define INTERFACE IKsObject
594			DECLARE_INTERFACE_(IKsObject, IUnknown)
595			{
596			STDMETHOD_(HANDLE, KsGetObjectHandle)(
597			THIS
598			) PURE;
599			};
600
601			interface DECLSPEC_UUID("97ebaacb-95bd-11d0-a3ea-00a0c9223196") IKsQualityForwarder;
602			#undef INTERFACE
603			#define INTERFACE IKsQualityForwarder
604			DECLARE_INTERFACE_(IKsQualityForwarder, IKsObject)
605			{
606			STDMETHOD_(VOID, KsFlushClient)(
607			THIS_
608			IKsPin* Pin
609			) PURE;
610			};
611
612			KSDDKAPI
613			HRESULT
614			WINAPI
615			KsResolveRequiredAttributes(
616			PKSDATARANGE DataRange,
617			PKSMULTIPLE_ITEM Attributes OPTIONAL
618			);
619
620			KSDDKAPI
621			HRESULT
622			WINAPI
623			KsOpenDefaultDevice(
624			REFGUID Category,
625			ACCESS_MASK Access,
626			PHANDLE DeviceHandle
627			);
628			KSDDKAPI
629			HRESULT
630			WINAPI
631			KsSynchronousDeviceControl(
632			HANDLE Handle,
633			ULONG IoControl,
634			PVOID InBuffer,
635			ULONG InLength,
636			PVOID OutBuffer,
637			ULONG OutLength,
638			PULONG BytesReturned
639			);
640			KSDDKAPI
641			HRESULT
642			WINAPI
643			KsGetMultiplePinFactoryItems(
644			HANDLE FilterHandle,
645			ULONG PinFactoryId,
646			ULONG PropertyId,
647			PVOID* Items
648			);
649			KSDDKAPI
650			HRESULT
651			WINAPI
652			KsGetMediaTypeCount(
653			HANDLE FilterHandle,
654			ULONG PinFactoryId,
655			ULONG* MediaTypeCount
656			);
657			KSDDKAPI
658			HRESULT
659			WINAPI
660			KsGetMediaType(
661			int Position,
662			AM_MEDIA_TYPE* AmMediaType,
663			HANDLE FilterHandle,
664			ULONG PinFactoryId
665			);
666
667			#endif // __STREAMS__
668
669			#ifndef _IKsPropertySet_
670			#if !defined(__cplusplus) \|\| _MSC_VER < 1100
671			DEFINE_GUIDEX(IID_IKsPropertySet);
672			#endif // !defined(__cplusplus) \|\| _MSC_VER < 1100
673			#endif // _IKsPropertySet_
674
675			#ifndef _IKsControl_
676			#if !defined(__cplusplus) \|\| _MSC_VER < 1100
677			DEFINE_GUIDEX(IID_IKsControl);
678			#endif // !defined(__cplusplus) \|\| _MSC_VER < 1100
679			#endif // _IKsControl_
680
681			#if !defined(__cplusplus) \|\| _MSC_VER < 1100
682			DEFINE_GUIDEX(IID_IKsAggregateControl);
683			#endif // !defined(__cplusplus) \|\| _MSC_VER < 1100
684
685			#ifndef _IKsTopology_
686			#if !defined(__cplusplus) \|\| _MSC_VER < 1100
687			DEFINE_GUIDEX(IID_IKsTopology);
688			#endif // !defined(__cplusplus) \|\| _MSC_VER < 1100
689			#endif // _IKsTopology_
690
691			DEFINE_GUIDSTRUCT("17CCA71B-ECD7-11D0-B908-00A0C9223196", CLSID_Proxy);
692			#define CLSID_Proxy DEFINE_GUIDNAMED(CLSID_Proxy)
693
694			#else // !_KS_
695
696			#ifndef _IKsPropertySet_
697			#if !defined(__cplusplus) \|\| _MSC_VER < 1100
698			DEFINE_GUID(IID_IKsPropertySet, STATIC_IID_IKsPropertySet);
699			#endif // !defined(__cplusplus) \|\| _MSC_VER < 1100
700			#endif // _IKsPropertySet_
701
702			#if !defined(__cplusplus) \|\| _MSC_VER < 1100
703			DEFINE_GUID(CLSID_Proxy, STATIC_CLSID_Proxy);
704			#else // defined(__cplusplus) && _MSC_VER >= 1100
705			DECLSPEC_UUID("17CCA71B-ECD7-11D0-B908-00A0C9223196") CLSID_Proxy;
706			#endif // defined(__cplusplus) && _MSC_VER >= 1100
707
708			#endif // !_KS_
709
710			#ifndef _IKsPropertySet_
711			#define _IKsPropertySet_
712
713			#define KSPROPERTY_SUPPORT_GET 1
714			#define KSPROPERTY_SUPPORT_SET 2
715
716			#ifdef DECLARE_INTERFACE_
717
718			interface DECLSPEC_UUID("31EFAC30-515C-11d0-A9AA-00aa0061be93") IKsPropertySet;
719			#undef INTERFACE
720			#define INTERFACE IKsPropertySet
721			DECLARE_INTERFACE_(IKsPropertySet, IUnknown)
722			{
723			STDMETHOD(Set)(
724			THIS_
725			IN REFGUID PropSet,
726			IN ULONG Id,
727			IN LPVOID InstanceData,
728			IN ULONG InstanceLength,
729			IN LPVOID PropertyData,
730			IN ULONG DataLength
731			) PURE;
732
733			STDMETHOD(Get)(
734			THIS_
735			IN REFGUID PropSet,
736			IN ULONG Id,
737			IN LPVOID InstanceData,
738			IN ULONG InstanceLength,
739			OUT LPVOID PropertyData,
740			IN ULONG DataLength,
741			OUT ULONG* BytesReturned
742			) PURE;
743
744			STDMETHOD(QuerySupported)(
745			THIS_
746			IN REFGUID PropSet,
747			IN ULONG Id,
748			OUT ULONG* TypeSupport
749			) PURE;
750			};
751
752			#endif // DECLARE_INTERFACE_
753
754			#endif // _IKsPropertySet_
755
756			#ifndef _IKsControl_
757			#define _IKsControl_
758
759			#ifdef DECLARE_INTERFACE_
760
761			interface DECLSPEC_UUID("28F54685-06FD-11D2-B27A-00A0C9223196") IKsControl;
762			#undef INTERFACE
763			#define INTERFACE IKsControl
764			DECLARE_INTERFACE_(IKsControl, IUnknown)
765			{
766			STDMETHOD(KsProperty)(
767			THIS_
768			IN PKSPROPERTY Property,
769			IN ULONG PropertyLength,
770			IN OUT LPVOID PropertyData,
771			IN ULONG DataLength,
772			OUT ULONG* BytesReturned
773			) PURE;
774			STDMETHOD(KsMethod)(
775			THIS_
776			IN PKSMETHOD Method,
777			IN ULONG MethodLength,
778			IN OUT LPVOID MethodData,
779			IN ULONG DataLength,
780			OUT ULONG* BytesReturned
781			) PURE;
782			STDMETHOD(KsEvent)(
783			THIS_
784			IN PKSEVENT Event OPTIONAL,
785			IN ULONG EventLength,
786			IN OUT LPVOID EventData,
787			IN ULONG DataLength,
788			OUT ULONG* BytesReturned
789			) PURE;
790			};
791
792			#endif // DECLARE_INTERFACE_
793
794			#endif // _IKsControl_
795
796
797			#ifdef DECLARE_INTERFACE_
798
799			interface DECLSPEC_UUID("7F40EAC0-3947-11D2-874E-00A0C9223196") IKsAggregateControl;
800			#undef INTERFACE
801			#define INTERFACE IKsAggregateControl
802			DECLARE_INTERFACE_(IKsAggregateControl, IUnknown)
803			{
804			STDMETHOD(KsAddAggregate)(
805			THIS_
806			IN REFGUID AggregateClass
807			) PURE;
808			STDMETHOD(KsRemoveAggregate)(
809			THIS_
810			IN REFGUID AggregateClass
811			) PURE;
812			};
813
814			#endif // DECLARE_INTERFACE_
815
816			#ifndef _IKsTopology_
817			#define _IKsTopology_
818
819			#ifdef DECLARE_INTERFACE_
820
821			interface DECLSPEC_UUID("28F54683-06FD-11D2-B27A-00A0C9223196") IKsTopology;
822			#undef INTERFACE
823			#define INTERFACE IKsTopology
824			DECLARE_INTERFACE_(IKsTopology, IUnknown)
825			{
826			STDMETHOD(CreateNodeInstance)(
827			THIS_
828			IN ULONG NodeId,
829			IN ULONG Flags,
830			IN ACCESS_MASK DesiredAccess,
831			IN IUnknown* UnkOuter OPTIONAL,
832			IN REFGUID InterfaceId,
833			OUT LPVOID* Interface
834			) PURE;
835			};
836
837			#endif // DECLARE_INTERFACE_
838
839			#endif // _IKsTopology_
840
841			#ifdef __cplusplus
842			}
843			#endif // __cplusplus
844
845			#endif // __KSPROXY__