* Update dmusicks.h annotations.

svn path=/trunk/; revision=55264
This commit is contained in:
Amine Khaldi 2012-01-27 21:27:13 +00:00
parent d07efed2e7
commit 6f45707947

View file

@ -46,7 +46,7 @@ DECLARE_INTERFACE_(IMasterClock,IUnknown) {
DEFINE_ABSTRACT_UNKNOWN() DEFINE_ABSTRACT_UNKNOWN()
STDMETHOD_(NTSTATUS,GetTime)( THIS_ STDMETHOD_(NTSTATUS,GetTime)( THIS_
OUT REFERENCE_TIME *pTime _Out_ REFERENCE_TIME *pTime
) PURE; ) PURE;
}; };
@ -54,7 +54,7 @@ typedef IMasterClock *PMASTERCLOCK;
#define IMP_IMasterClock \ #define IMP_IMasterClock \
STDMETHODIMP_(NTSTATUS) GetTime( \ STDMETHODIMP_(NTSTATUS) GetTime( \
OUT REFERENCE_TIME *pTime \ _Out_ REFERENCE_TIME *pTime \
) )
/* =============================================================== /* ===============================================================
@ -69,27 +69,27 @@ typedef struct IMXF *PMXF;
#define DEFINE_ABSTRACT_IMXF() \ #define DEFINE_ABSTRACT_IMXF() \
STDMETHOD_(NTSTATUS,SetState)(THIS_ \ STDMETHOD_(NTSTATUS,SetState)(THIS_ \
IN KSSTATE State \ _In_ KSSTATE State \
) PURE; \ ) PURE; \
STDMETHOD_(NTSTATUS,PutMessage)(THIS_ \ STDMETHOD_(NTSTATUS,PutMessage)(THIS_ \
IN PDMUS_KERNEL_EVENT pDMKEvt \ _In_ PDMUS_KERNEL_EVENT pDMKEvt \
) PURE; \ ) PURE; \
STDMETHOD_(NTSTATUS,ConnectOutput)(THIS_ \ STDMETHOD_(NTSTATUS,ConnectOutput)(THIS_ \
IN PMXF sinkMXF \ _In_ PMXF sinkMXF \
) PURE; \ ) PURE; \
STDMETHOD_(NTSTATUS,DisconnectOutput)(THIS_ \ STDMETHOD_(NTSTATUS,DisconnectOutput)(THIS_ \
IN PMXF sinkMXF \ _In_ PMXF sinkMXF \
) PURE; ) PURE;
#define IMP_IMXF \ #define IMP_IMXF \
STDMETHODIMP_(NTSTATUS) SetState ( \ STDMETHODIMP_(NTSTATUS) SetState ( \
IN KSSTATE State); \ _In_ KSSTATE State); \
STDMETHODIMP_(NTSTATUS) PutMessage (THIS_ \ STDMETHODIMP_(NTSTATUS) PutMessage (THIS_ \
IN PDMUS_KERNEL_EVENT pDMKEvt); \ _In_ PDMUS_KERNEL_EVENT pDMKEvt); \
STDMETHODIMP_(NTSTATUS) ConnectOutput (THIS_ \ STDMETHODIMP_(NTSTATUS) ConnectOutput (THIS_ \
IN PMXF sinkMXF); \ _In_ PMXF sinkMXF); \
STDMETHODIMP_(NTSTATUS) DisconnectOutput (THIS_ \ STDMETHODIMP_(NTSTATUS) DisconnectOutput (THIS_ \
IN PMXF sinkMXF) _In_ PMXF sinkMXF)
DECLARE_INTERFACE_(IMXF,IUnknown) { DECLARE_INTERFACE_(IMXF,IUnknown) {
DEFINE_ABSTRACT_UNKNOWN() DEFINE_ABSTRACT_UNKNOWN()
@ -118,32 +118,33 @@ DECLARE_INTERFACE_(IAllocatorMXF, IMXF) {
DEFINE_ABSTRACT_IMXF() DEFINE_ABSTRACT_IMXF()
STDMETHOD_(NTSTATUS,GetMessage)(THIS_ STDMETHOD_(NTSTATUS,GetMessage)(THIS_
OUT PDMUS_KERNEL_EVENT *ppDMKEvt _Out_ PDMUS_KERNEL_EVENT *ppDMKEvt
) PURE; ) PURE;
STDMETHOD_(USHORT,GetBufferSize)(THIS) PURE; STDMETHOD_(USHORT,GetBufferSize)(THIS) PURE;
STDMETHOD_(NTSTATUS,GetBuffer)(THIS_ STDMETHOD_(NTSTATUS,GetBuffer)(THIS_
OUT PBYTE *ppBuffer _Outptr_result_bytebuffer_(_Inexpressible_(GetBufferSize bytes)) PBYTE *ppBuffer
)PURE; )PURE;
STDMETHOD_(NTSTATUS,PutBuffer)(THIS_ STDMETHOD_(NTSTATUS,PutBuffer)(THIS_
IN PBYTE pBuffer _In_ PBYTE pBuffer
) PURE; ) PURE;
}; };
#define IMP_IAllocatorMXF \ #define IMP_IAllocatorMXF \
IMP_IMXF; \ IMP_IMXF; \
STDMETHODIMP_(NTSTATUS) GetMessage( \ STDMETHODIMP_(NTSTATUS) GetMessage( \
OUT PDMUS_KERNEL_EVENT *ppDMKEvt); \ _Out_ PDMUS_KERNEL_EVENT *ppDMKEvt); \
\ \
STDMETHODIMP_(USHORT) GetBufferSize(void); \ STDMETHODIMP_(USHORT) GetBufferSize(void); \
\ \
STDMETHODIMP_(NTSTATUS) GetBuffer( \ STDMETHODIMP_(NTSTATUS) GetBuffer( \
OUT PBYTE *ppBuffer); \ _Outptr_result_bytebuffer_(_Inexpressible_(GetBufferSize bytes)) \
PBYTE *ppBuffer); \
\ \
STDMETHODIMP_(NTSTATUS) PutBuffer( \ STDMETHODIMP_(NTSTATUS) PutBuffer( \
IN PBYTE pBuffer) _In_ PBYTE pBuffer)
#undef INTERFACE #undef INTERFACE
#define INTERFACE IPortDMus #define INTERFACE IPortDMus
@ -157,11 +158,11 @@ DECLARE_INTERFACE_(IPortDMus, IPort) {
DEFINE_ABSTRACT_PORT() DEFINE_ABSTRACT_PORT()
STDMETHOD_(void,Notify)(THIS_ STDMETHOD_(void,Notify)(THIS_
IN PSERVICEGROUP ServiceGroup OPTIONAL _In_opt_ PSERVICEGROUP ServiceGroup
) PURE; ) PURE;
STDMETHOD_(void,RegisterServiceGroup)(THIS_ STDMETHOD_(void,RegisterServiceGroup)(THIS_
IN PSERVICEGROUP ServiceGroup _In_ PSERVICEGROUP ServiceGroup
) PURE; ) PURE;
}; };
typedef IPortDMus *PPORTDMUS; typedef IPortDMus *PPORTDMUS;
@ -169,10 +170,10 @@ typedef IPortDMus *PPORTDMUS;
#define IMP_IPortDMus \ #define IMP_IPortDMus \
IMP_IPort; \ IMP_IPort; \
STDMETHODIMP_(void) Notify( \ STDMETHODIMP_(void) Notify( \
IN PSERVICEGROUP ServiceGroup OPTIONAL); \ _In_opt_ PSERVICEGROUP ServiceGroup); \
\ \
STDMETHODIMP_(void) RegisterServiceGroup( \ STDMETHODIMP_(void) RegisterServiceGroup( \
IN PSERVICEGROUP ServiceGroup) _In_ PSERVICEGROUP ServiceGroup)
#undef INTERFACE #undef INTERFACE
#define INTERFACE IMiniportDMus #define INTERFACE IMiniportDMus
@ -185,25 +186,25 @@ DECLARE_INTERFACE_(IMiniportDMus, IMiniport) {
DEFINE_ABSTRACT_MINIPORT() DEFINE_ABSTRACT_MINIPORT()
STDMETHOD_(NTSTATUS,Init)(THIS_ STDMETHOD_(NTSTATUS,Init)(THIS_
IN PUNKNOWN UnknownAdapter, _In_opt_ PUNKNOWN UnknownAdapter,
IN PRESOURCELIST ResourceList, _In_ PRESOURCELIST ResourceList,
IN PPORTDMUS Port, _In_ PPORTDMUS Port,
OUT PSERVICEGROUP *ServiceGroup _Out_ PSERVICEGROUP *ServiceGroup
) PURE; ) PURE;
STDMETHOD_(void,Service)(THIS) PURE; STDMETHOD_(void,Service)(THIS) PURE;
STDMETHOD_(NTSTATUS,NewStream)(THIS_ STDMETHOD_(NTSTATUS,NewStream)(THIS_
OUT PMXF *MXF, _Out_ PMXF *MXF,
IN PUNKNOWN OuterUnknown OPTIONAL, _In_opt_ PUNKNOWN OuterUnknown,
IN POOL_TYPE PoolType, _In_ POOL_TYPE PoolType,
IN ULONG PinID, _In_ ULONG PinID,
IN DMUS_STREAM_TYPE StreamType, _In_ DMUS_STREAM_TYPE StreamType,
IN PKSDATAFORMAT DataFormat, _In_ PKSDATAFORMAT DataFormat,
OUT PSERVICEGROUP *ServiceGroup, _Out_ PSERVICEGROUP *ServiceGroup,
IN PAllocatorMXF AllocatorMXF, _In_ PAllocatorMXF AllocatorMXF,
IN PMASTERCLOCK MasterClock, _In_ PMASTERCLOCK MasterClock,
OUT PULONGLONG SchedulePreFetch _Out_ PULONGLONG SchedulePreFetch
) PURE; ) PURE;
}; };
@ -213,24 +214,24 @@ typedef IMiniportDMus *PMINIPORTDMUS;
#define IMP_IMiniportDMus \ #define IMP_IMiniportDMus \
IMP_IMiniport; \ IMP_IMiniport; \
STDMETHODIMP_(NTSTATUS) Init( \ STDMETHODIMP_(NTSTATUS) Init( \
IN PUNKNOWN UnknownAdapter, \ _In_opt_ PUNKNOWN UnknownAdapter, \
IN PRESOURCELIST ResourceList, \ _In_ PRESOURCELIST ResourceList, \
IN PPORTDMUS Port, \ _In_ PPORTDMUS Port, \
OUT PSERVICEGROUP *ServiceGroup); \ _Out_ PSERVICEGROUP *ServiceGroup); \
\ \
STDMETHODIMP_(void) Service(THIS); \ STDMETHODIMP_(void) Service(THIS); \
\ \
STDMETHODIMP_(NTSTATUS) NewStream( \ STDMETHODIMP_(NTSTATUS) NewStream( \
OUT PMXF *MXF, \ _Out_ PMXF *MXF, \
IN PUNKNOWN OuterUnknown, \ _In_opt_ PUNKNOWN OuterUnknown, \
IN POOL_TYPE PoolType, \ _In_ POOL_TYPE PoolType, \
IN ULONG PinID, \ _In_ ULONG PinID, \
IN DMUS_STREAM_TYPE StreamType, \ _In_ DMUS_STREAM_TYPE StreamType, \
IN PKSDATAFORMAT DataFormat, \ _In_ PKSDATAFORMAT DataFormat, \
OUT PSERVICEGROUP *ServiceGroup, \ _Out_ PSERVICEGROUP *ServiceGroup, \
IN PAllocatorMXF AllocatorMXF, \ _In_ PAllocatorMXF AllocatorMXF, \
IN PMASTERCLOCK MasterClock, \ _In_ PMASTERCLOCK MasterClock, \
OUT PULONGLONG SchedulePreFetch) _Out_ PULONGLONG SchedulePreFetch)
#define STATIC_KSAUDFNAME_DMUSIC_MPU_OUT\ #define STATIC_KSAUDFNAME_DMUSIC_MPU_OUT\