2 * COPYRIGHT: See COPYING in the top level directory
3 * PROJECT: ReactOS Kernel Streaming
4 * FILE: drivers/ksfilter/ks/filter.c
5 * PURPOSE: KS IKsFilter interface functions
6 * PROGRAMMER: Johannes Anderwald
14 KSBASIC_HEADER Header
;
17 IKsControlVtbl
*lpVtblKsControl
;
18 IKsFilterFactory
* FilterFactory
;
19 IKsProcessingObjectVtbl
* lpVtblKsProcessingObject
;
22 PKSIOBJECT_HEADER ObjectHeader
;
24 PKSFILTERFACTORY Factory
;
25 PFILE_OBJECT FileObject
;
27 KMUTEX ProcessingMutex
;
30 WORK_QUEUE_ITEM WorkItem
;
33 PFNKSFILTERPOWER Sleep
;
34 PFNKSFILTERPOWER Wake
;
36 ULONG
*PinInstanceCount
;
38 PKSPROCESSPIN_INDEXENTRY ProcessPinIndex
;
42 const GUID IID_IKsControl
= {0x28F54685L
, 0x06FD, 0x11D2, {0xB2, 0x7A, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96}};
43 const GUID IID_IKsFilter
= {0x3ef6ee44L
, 0x0D41, 0x11d2, {0xbe, 0xDA, 0x00, 0xc0, 0x4f, 0x8e, 0xF4, 0x57}};
44 const GUID KSPROPSETID_Topology
= {0x720D4AC0L
, 0x7533, 0x11D0, {0xA5, 0xD6, 0x28, 0xDB, 0x04, 0xC1, 0x00, 0x00}};
45 const GUID KSPROPSETID_Pin
= {0x8C134960L
, 0x51AD, 0x11CF, {0x87, 0x8A, 0x94, 0xF8, 0x01, 0xC1, 0x00, 0x00}};
48 IKsFilter_RemoveFilterFromFilterFactory(
50 PKSFILTERFACTORY FilterFactory
);
52 NTSTATUS NTAPI
FilterTopologyPropertyHandler(IN PIRP Irp
, IN PKSIDENTIFIER Request
, IN OUT PVOID Data
);
53 NTSTATUS NTAPI
FilterPinPropertyHandler(IN PIRP Irp
, IN PKSIDENTIFIER Request
, IN OUT PVOID Data
);
56 DEFINE_KSPROPERTY_TOPOLOGYSET(IKsFilterTopologySet
, FilterTopologyPropertyHandler
);
57 DEFINE_KSPROPERTY_PINPROPOSEDATAFORMAT(IKsFilterPinSet
, FilterPinPropertyHandler
, FilterPinPropertyHandler
, FilterPinPropertyHandler
);
59 KSPROPERTY_SET FilterPropertySet
[] =
62 &KSPROPSETID_Topology
,
63 sizeof(IKsFilterTopologySet
) / sizeof(KSPROPERTY_ITEM
),
64 (const KSPROPERTY_ITEM
*)&IKsFilterTopologySet
,
70 sizeof(IKsFilterPinSet
) / sizeof(KSPROPERTY_ITEM
),
71 (const KSPROPERTY_ITEM
*)&IKsFilterPinSet
,
79 IKsProcessingObject_fnQueryInterface(
80 IKsProcessingObject
* iface
,
84 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
86 if (IsEqualGUIDAligned(refiid
, &IID_IUnknown
))
88 *Output
= &This
->Header
.OuterUnknown
;
89 _InterlockedIncrement(&This
->ref
);
90 return STATUS_SUCCESS
;
92 return STATUS_UNSUCCESSFUL
;
97 IKsProcessingObject_fnAddRef(
98 IKsProcessingObject
* iface
)
100 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
102 return InterlockedIncrement(&This
->ref
);
107 IKsProcessingObject_fnRelease(
108 IKsProcessingObject
* iface
)
110 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
112 InterlockedDecrement(&This
->ref
);
114 /* Return new reference count */
120 IKsProcessingObject_fnProcessingObjectWork(
121 IKsProcessingObject
* iface
)
124 LARGE_INTEGER TimeOut
;
125 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
127 DPRINT1("processing object\n");
128 /* first check if running at passive level */
129 if (KeGetCurrentIrql() == PASSIVE_LEVEL
)
131 /* acquire processing mutex */
132 KeWaitForSingleObject(&This
->ControlMutex
, Executive
, KernelMode
, FALSE
, NULL
);
136 /* dispatch level processing */
137 if (KeReadStateMutex(&This
->ControlMutex
) == 0)
139 /* some thread was faster */
140 DPRINT1("processing object too slow\n");
144 /* acquire processing mutex */
145 TimeOut
.QuadPart
= 0LL;
146 Status
= KeWaitForSingleObject(&This
->ControlMutex
, Executive
, KernelMode
, FALSE
, &TimeOut
);
148 if (Status
== STATUS_TIMEOUT
)
150 /* some thread was faster */
151 DPRINT1("processing object too slow\n");
159 /* check if the and-gate has been enabled again */
160 if (&This
->Gate
.Count
!= 0)
163 DPRINT1("processing object gate open\n");
167 DPRINT1("IKsProcessingObject_fnProcessingObjectWork not implemented\n");
172 /* release process mutex */
173 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
178 IKsProcessingObject_fnGetAndGate(
179 IKsProcessingObject
* iface
)
181 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
183 /* return and gate */
189 IKsProcessingObject_fnProcess(
190 IKsProcessingObject
* iface
,
191 IN BOOLEAN Asynchronous
)
193 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
195 /* should the action be asynchronous */
198 /* queue work item */
199 KsQueueWorkItem(This
->Worker
, &This
->WorkItem
);
200 DPRINT1("queueing\n");
205 /* does the filter require explicit deferred processing */
206 if ((This
->Filter
.Descriptor
->Flags
& (KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING
| KSFILTER_FLAG_CRITICAL_PROCESSING
| KSFILTER_FLAG_HYPERCRITICAL_PROCESSING
)) &&
207 KeGetCurrentIrql() > PASSIVE_LEVEL
)
209 /* queue work item */
210 KsQueueWorkItem(This
->Worker
, &This
->WorkItem
);
211 DPRINT1("queueing\n");
216 /* call worker routine directly */
217 iface
->lpVtbl
->ProcessingObjectWork(iface
);
222 IKsProcessingObject_fnReset(
223 IKsProcessingObject
* iface
)
225 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
227 /* acquire processing mutex */
228 KeWaitForSingleObject(&This
->ProcessingMutex
, Executive
, KernelMode
, FALSE
, NULL
);
230 /* check if the filter supports dispatch routines */
231 if (This
->Filter
.Descriptor
->Dispatch
)
233 /* has the filter a reset routine */
234 if (This
->Filter
.Descriptor
->Dispatch
->Reset
)
237 This
->Filter
.Descriptor
->Dispatch
->Reset(&This
->Filter
);
241 /* release process mutex */
242 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
247 IKsProcessingObject_fnTriggerNotification(
248 IKsProcessingObject
* iface
)
253 static IKsProcessingObjectVtbl vt_IKsProcessingObject
=
255 IKsProcessingObject_fnQueryInterface
,
256 IKsProcessingObject_fnAddRef
,
257 IKsProcessingObject_fnRelease
,
258 IKsProcessingObject_fnProcessingObjectWork
,
259 IKsProcessingObject_fnGetAndGate
,
260 IKsProcessingObject_fnProcess
,
261 IKsProcessingObject_fnReset
,
262 IKsProcessingObject_fnTriggerNotification
266 //---------------------------------------------------------------------------------------------------------
269 IKsControl_fnQueryInterface(
274 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
276 if (IsEqualGUIDAligned(refiid
, &IID_IUnknown
))
278 *Output
= &This
->Header
.OuterUnknown
;
279 _InterlockedIncrement(&This
->ref
);
280 return STATUS_SUCCESS
;
282 return STATUS_UNSUCCESSFUL
;
290 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
292 return InterlockedIncrement(&This
->ref
);
297 IKsControl_fnRelease(
300 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
302 InterlockedDecrement(&This
->ref
);
304 /* Return new reference count */
310 IKsControl_fnKsProperty(
312 IN PKSPROPERTY Property
,
313 IN ULONG PropertyLength
,
314 IN OUT PVOID PropertyData
,
316 OUT ULONG
* BytesReturned
)
318 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
320 return KsSynchronousIoControlDevice(This
->FileObject
, KernelMode
, IOCTL_KS_PROPERTY
, Property
, PropertyLength
, PropertyData
, DataLength
, BytesReturned
);
326 IKsControl_fnKsMethod(
329 IN ULONG MethodLength
,
330 IN OUT PVOID MethodData
,
332 OUT ULONG
* BytesReturned
)
334 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
336 return KsSynchronousIoControlDevice(This
->FileObject
, KernelMode
, IOCTL_KS_METHOD
, Method
, MethodLength
, MethodData
, DataLength
, BytesReturned
);
342 IKsControl_fnKsEvent(
344 IN PKSEVENT Event OPTIONAL
,
345 IN ULONG EventLength
,
346 IN OUT PVOID EventData
,
348 OUT ULONG
* BytesReturned
)
350 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
354 return KsSynchronousIoControlDevice(This
->FileObject
, KernelMode
, IOCTL_KS_ENABLE_EVENT
, Event
, EventLength
, EventData
, DataLength
, BytesReturned
);
358 return KsSynchronousIoControlDevice(This
->FileObject
, KernelMode
, IOCTL_KS_DISABLE_EVENT
, EventData
, DataLength
, NULL
, 0, BytesReturned
);
363 static IKsControlVtbl vt_IKsControl
=
365 IKsControl_fnQueryInterface
,
367 IKsControl_fnRelease
,
368 IKsControl_fnKsProperty
,
369 IKsControl_fnKsMethod
,
376 IKsFilter_fnQueryInterface(
382 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
384 if (IsEqualGUIDAligned(refiid
, &IID_IUnknown
) ||
385 IsEqualGUIDAligned(refiid
, &IID_IKsFilter
))
387 *Output
= &This
->Header
.OuterUnknown
;
388 _InterlockedIncrement(&This
->ref
);
389 return STATUS_SUCCESS
;
391 else if (IsEqualGUIDAligned(refiid
, &IID_IKsControl
))
393 *Output
= &This
->lpVtblKsControl
;
394 _InterlockedIncrement(&This
->ref
);
395 return STATUS_SUCCESS
;
398 if (This
->Header
.ClientAggregate
)
400 /* using client aggregate */
401 Status
= This
->Header
.ClientAggregate
->lpVtbl
->QueryInterface(This
->Header
.ClientAggregate
, refiid
, Output
);
403 if (NT_SUCCESS(Status
))
405 /* client aggregate supports interface */
410 DPRINT("IKsFilter_fnQueryInterface no interface\n");
411 return STATUS_NOT_SUPPORTED
;
419 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
421 return InterlockedIncrement(&This
->ref
);
429 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
431 InterlockedDecrement(&This
->ref
);
438 /* Return new reference count */
445 IKsFilter_fnGetStruct(
448 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
450 return &This
->Filter
;
455 IKsFilter_fnDoAllNecessaryPinsExist(
464 IKsFilter_fnCreateNode(
468 IN PLIST_ENTRY ListEntry
)
471 return STATUS_NOT_IMPLEMENTED
;
476 IKsFilter_fnBindProcessPinsToPipeSection(
478 IN
struct KSPROCESSPIPESECTION
*Section
,
482 OUT PKSGATE
*OutGate
)
485 return STATUS_NOT_IMPLEMENTED
;
490 IKsFilter_fnUnbindProcessPinsFromPipeSection(
492 IN
struct KSPROCESSPIPESECTION
*Section
)
495 return STATUS_NOT_IMPLEMENTED
;
500 IKsFilter_fnAddProcessPin(
502 IN PKSPROCESSPIN ProcessPin
)
505 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
507 /* first acquire processing mutex */
508 KeWaitForSingleObject(&This
->ProcessingMutex
, Executive
, KernelMode
, FALSE
, NULL
);
511 ASSERT(This
->Filter
.Descriptor
->PinDescriptorsCount
> ProcessPin
->Pin
->Id
);
513 /* allocate new process pin array */
514 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Pins
,
515 (This
->Filter
.Descriptor
->PinDescriptorsCount
+ 1) * sizeof(PVOID
),
516 This
->Filter
.Descriptor
->PinDescriptorsCount
* sizeof(PVOID
),
519 if (NT_SUCCESS(Status
))
521 /* store process pin */
522 This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Pins
[This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
] = ProcessPin
;
523 This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
++;
526 /* release process mutex */
527 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
534 IKsFilter_fnRemoveProcessPin(
536 IN PKSPROCESSPIN ProcessPin
)
540 PKSPROCESSPIN
* Pins
;
542 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
544 /* first acquire processing mutex */
545 KeWaitForSingleObject(&This
->ProcessingMutex
, Executive
, KernelMode
, FALSE
, NULL
);
548 ASSERT(ProcessPin
->Pin
);
549 ASSERT(ProcessPin
->Pin
->Id
);
551 Count
= This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
;
552 Pins
= This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Pins
;
554 /* search for current process pin */
555 for(Index
= 0; Index
< Count
; Index
++)
557 if (Pins
[Index
] == ProcessPin
)
559 RtlMoveMemory(&Pins
[Index
], &Pins
[Index
+ 1], (Count
- (Index
+ 1)) * sizeof(PVOID
));
565 /* decrement pin count */
566 This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
--;
568 if (!This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
)
570 /* clear entry object bag will delete it */
571 This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Pins
= NULL
;
574 /* release process mutex */
575 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
578 return STATUS_SUCCESS
;
583 IKsFilter_fnReprepareProcessPipeSection(
585 IN
struct KSPROCESSPIPESECTION
*PipeSection
,
594 IKsFilter_fnDeliverResetState(
596 IN
struct KSPROCESSPIPESECTION
*PipeSection
,
597 IN KSRESET ResetState
)
604 IKsFilter_fnIsFrameHolding(
613 IKsFilter_fnRegisterForCopyCallbacks(
621 PKSPROCESSPIN_INDEXENTRY
623 IKsFilter_fnGetProcessDispatch(
626 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
628 return This
->ProcessPinIndex
;
631 static IKsFilterVtbl vt_IKsFilter
=
633 IKsFilter_fnQueryInterface
,
636 IKsFilter_fnGetStruct
,
637 IKsFilter_fnDoAllNecessaryPinsExist
,
638 IKsFilter_fnCreateNode
,
639 IKsFilter_fnBindProcessPinsToPipeSection
,
640 IKsFilter_fnUnbindProcessPinsFromPipeSection
,
641 IKsFilter_fnAddProcessPin
,
642 IKsFilter_fnRemoveProcessPin
,
643 IKsFilter_fnReprepareProcessPipeSection
,
644 IKsFilter_fnDeliverResetState
,
645 IKsFilter_fnIsFrameHolding
,
646 IKsFilter_fnRegisterForCopyCallbacks
,
647 IKsFilter_fnGetProcessDispatch
651 IKsFilter_GetFilterFromIrp(
653 OUT IKsFilter
**Filter
)
655 PIO_STACK_LOCATION IoStack
;
656 PKSIOBJECT_HEADER ObjectHeader
;
659 /* get current irp stack */
660 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
663 ASSERT(IoStack
->FileObject
!= NULL
);
665 ObjectHeader
= (PKSIOBJECT_HEADER
)IoStack
->FileObject
->FsContext2
;
667 /* sanity is important */
668 ASSERT(ObjectHeader
!= NULL
);
669 ASSERT(ObjectHeader
->Type
== KsObjectTypeFilter
);
670 ASSERT(ObjectHeader
->Unknown
!= NULL
);
672 /* get our private interface */
673 Status
= ObjectHeader
->Unknown
->lpVtbl
->QueryInterface(ObjectHeader
->Unknown
, &IID_IKsFilter
, (PVOID
*)Filter
);
675 if (!NT_SUCCESS(Status
))
677 /* something is wrong here */
678 DPRINT1("KS: Misbehaving filter %p\n", ObjectHeader
->Unknown
);
679 Irp
->IoStatus
.Status
= Status
;
681 /* complete and forget irp */
682 CompleteRequest(Irp
, IO_NO_INCREMENT
);
691 IKsFilter_DispatchClose(
692 IN PDEVICE_OBJECT DeviceObject
,
696 IKsFilterImpl
* This
;
699 /* obtain filter from object header */
700 Status
= IKsFilter_GetFilterFromIrp(Irp
, &Filter
);
701 if (!NT_SUCCESS(Status
))
704 /* get our real implementation */
705 This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Header
.OuterUnknown
);
707 /* does the driver support notifications */
708 if (This
->Filter
.Descriptor
&& This
->Filter
.Descriptor
->Dispatch
&& This
->Filter
.Descriptor
->Dispatch
->Close
)
710 /* call driver's filter close function */
711 Status
= This
->Filter
.Descriptor
->Dispatch
->Close(&This
->Filter
, Irp
);
714 if (NT_SUCCESS(Status
) && Status
!= STATUS_PENDING
)
716 /* save the result */
717 Irp
->IoStatus
.Status
= Status
;
719 CompleteRequest(Irp
, IO_NO_INCREMENT
);
721 /* remove our instance from the filter factory */
722 IKsFilter_RemoveFilterFromFilterFactory(This
, This
->Factory
);
724 /* free object header */
725 KsFreeObjectHeader(This
->ObjectHeader
);
729 /* complete and forget */
730 Irp
->IoStatus
.Status
= Status
;
732 CompleteRequest(Irp
, IO_NO_INCREMENT
);
740 KspHandlePropertyInstances(
741 IN PIO_STATUS_BLOCK IoStatus
,
742 IN PKSIDENTIFIER Request
,
744 IN IKsFilterImpl
* This
,
747 KSPIN_CINSTANCES
* Instances
;
748 KSP_PIN
* Pin
= (KSP_PIN
*)Request
;
750 if (!This
->Filter
.Descriptor
|| !This
->Filter
.Descriptor
->PinDescriptorsCount
)
752 /* no filter / pin descriptor */
753 IoStatus
->Status
= STATUS_NOT_IMPLEMENTED
;
754 return STATUS_NOT_IMPLEMENTED
;
757 /* ignore custom structs for now */
758 ASSERT(This
->Filter
.Descriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
759 ASSERT(This
->Filter
.Descriptor
->PinDescriptorsCount
> Pin
->PinId
);
761 Instances
= (KSPIN_CINSTANCES
*)Data
;
762 /* max instance count */
763 Instances
->PossibleCount
= This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].InstancesPossible
;
764 /* current instance count */
765 Instances
->CurrentCount
= This
->PinInstanceCount
[Pin
->PinId
];
767 IoStatus
->Information
= sizeof(KSPIN_CINSTANCES
);
768 IoStatus
->Status
= STATUS_SUCCESS
;
769 return STATUS_SUCCESS
;
773 KspHandleNecessaryPropertyInstances(
774 IN PIO_STATUS_BLOCK IoStatus
,
775 IN PKSIDENTIFIER Request
,
777 IN IKsFilterImpl
* This
)
780 KSP_PIN
* Pin
= (KSP_PIN
*)Request
;
782 if (!This
->Filter
.Descriptor
|| !This
->Filter
.Descriptor
->PinDescriptorsCount
)
784 /* no filter / pin descriptor */
785 IoStatus
->Status
= STATUS_NOT_IMPLEMENTED
;
786 return STATUS_NOT_IMPLEMENTED
;
789 /* ignore custom structs for now */
790 ASSERT(This
->Filter
.Descriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
791 ASSERT(This
->Filter
.Descriptor
->PinDescriptorsCount
> Pin
->PinId
);
793 Result
= (PULONG
)Data
;
794 *Result
= This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].InstancesNecessary
;
796 IoStatus
->Information
= sizeof(ULONG
);
797 IoStatus
->Status
= STATUS_SUCCESS
;
798 return STATUS_SUCCESS
;
802 KspHandleDataIntersection(
804 IN PIO_STATUS_BLOCK IoStatus
,
805 IN PKSIDENTIFIER Request
,
808 IN IKsFilterImpl
* This
)
810 PKSMULTIPLE_ITEM MultipleItem
;
811 PKSDATARANGE DataRange
;
812 NTSTATUS Status
= STATUS_NO_MATCH
;
814 PIO_STACK_LOCATION IoStack
;
815 KSP_PIN
* Pin
= (KSP_PIN
*)Request
;
817 /* get stack location */
818 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
821 ASSERT(DataLength
== IoStack
->Parameters
.DeviceIoControl
.OutputBufferLength
);
823 /* Access parameters */
824 MultipleItem
= (PKSMULTIPLE_ITEM
)(Pin
+ 1);
825 DataRange
= (PKSDATARANGE
)(MultipleItem
+ 1);
827 /* FIXME make sure its 64 bit aligned */
828 ASSERT(((ULONG_PTR
)DataRange
& 0x7) == 0);
830 if (!This
->Filter
.Descriptor
|| !This
->Filter
.Descriptor
->PinDescriptorsCount
)
832 /* no filter / pin descriptor */
833 IoStatus
->Status
= STATUS_NOT_IMPLEMENTED
;
834 return STATUS_NOT_IMPLEMENTED
;
837 /* ignore custom structs for now */
838 ASSERT(This
->Filter
.Descriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
839 ASSERT(This
->Filter
.Descriptor
->PinDescriptorsCount
> Pin
->PinId
);
841 if (This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].IntersectHandler
== NULL
||
842 This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].PinDescriptor
.DataRanges
== NULL
||
843 This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].PinDescriptor
.DataRangesCount
== 0)
845 /* no driver supported intersect handler / no provided data ranges */
846 IoStatus
->Status
= STATUS_NOT_IMPLEMENTED
;
847 return STATUS_NOT_IMPLEMENTED
;
850 for(Index
= 0; Index
< MultipleItem
->Count
; Index
++)
852 UNICODE_STRING MajorFormat
, SubFormat
, Specifier
;
853 /* convert the guid to string */
854 RtlStringFromGUID(&DataRange
->MajorFormat
, &MajorFormat
);
855 RtlStringFromGUID(&DataRange
->SubFormat
, &SubFormat
);
856 RtlStringFromGUID(&DataRange
->Specifier
, &Specifier
);
858 DPRINT("KspHandleDataIntersection Index %lu PinId %lu MajorFormat %S SubFormat %S Specifier %S FormatSize %lu SampleSize %lu Align %lu Flags %lx Reserved %lx DataLength %lu\n", Index
, Pin
->PinId
, MajorFormat
.Buffer
, SubFormat
.Buffer
, Specifier
.Buffer
,
859 DataRange
->FormatSize
, DataRange
->SampleSize
, DataRange
->Alignment
, DataRange
->Flags
, DataRange
->Reserved
, DataLength
);
861 /* FIXME implement KsPinDataIntersectionEx */
862 /* Call miniport's properitary handler */
863 Status
= This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].IntersectHandler(&This
->Filter
,
867 This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].PinDescriptor
.DataRanges
[0], /* HACK */
871 DPRINT("KspHandleDataIntersection Status %lx\n", Status
);
873 if (Status
== STATUS_SUCCESS
|| Status
== STATUS_BUFFER_OVERFLOW
|| Status
== STATUS_BUFFER_TOO_SMALL
)
876 IoStatus
->Information
= Length
;
880 DataRange
= UlongToPtr(PtrToUlong(DataRange
) + DataRange
->FormatSize
);
881 /* FIXME make sure its 64 bit aligned */
882 ASSERT(((ULONG_PTR
)DataRange
& 0x7) == 0);
884 IoStatus
->Status
= Status
;
890 FilterTopologyPropertyHandler(
892 IN PKSIDENTIFIER Request
,
895 IKsFilterImpl
* This
;
897 /* get filter implementation */
898 This
= (IKsFilterImpl
*)KSPROPERTY_ITEM_IRP_STORAGE(Irp
);
903 return KsTopologyPropertyHandler(Irp
, Request
, Data
, &This
->Topology
);
910 FilterPinPropertyHandler(
912 IN PKSIDENTIFIER Request
,
915 PIO_STACK_LOCATION IoStack
;
916 IKsFilterImpl
* This
;
917 NTSTATUS Status
= STATUS_UNSUCCESSFUL
;
919 /* get filter implementation */
920 This
= (IKsFilterImpl
*)KSPROPERTY_ITEM_IRP_STORAGE(Irp
);
925 /* get current stack location */
926 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
930 case KSPROPERTY_PIN_CTYPES
:
931 case KSPROPERTY_PIN_DATAFLOW
:
932 case KSPROPERTY_PIN_DATARANGES
:
933 case KSPROPERTY_PIN_INTERFACES
:
934 case KSPROPERTY_PIN_MEDIUMS
:
935 case KSPROPERTY_PIN_COMMUNICATION
:
936 case KSPROPERTY_PIN_CATEGORY
:
937 case KSPROPERTY_PIN_NAME
:
938 case KSPROPERTY_PIN_CONSTRAINEDDATARANGES
:
939 Status
= KspPinPropertyHandler(Irp
, Request
, Data
, This
->Filter
.Descriptor
->PinDescriptorsCount
, (const KSPIN_DESCRIPTOR
*)This
->Filter
.Descriptor
->PinDescriptors
, This
->Filter
.Descriptor
->PinDescriptorSize
);
941 case KSPROPERTY_PIN_GLOBALCINSTANCES
:
942 Status
= KspHandlePropertyInstances(&Irp
->IoStatus
, Request
, Data
, This
, TRUE
);
944 case KSPROPERTY_PIN_CINSTANCES
:
945 Status
= KspHandlePropertyInstances(&Irp
->IoStatus
, Request
, Data
, This
, FALSE
);
947 case KSPROPERTY_PIN_NECESSARYINSTANCES
:
948 Status
= KspHandleNecessaryPropertyInstances(&Irp
->IoStatus
, Request
, Data
, This
);
951 case KSPROPERTY_PIN_DATAINTERSECTION
:
952 Status
= KspHandleDataIntersection(Irp
, &Irp
->IoStatus
, Request
, Data
, IoStack
->Parameters
.DeviceIoControl
.OutputBufferLength
, This
);
956 Status
= STATUS_NOT_FOUND
;
958 //DPRINT("KspPinPropertyHandler Pins %lu Request->Id %lu Status %lx\n", This->PinDescriptorCount, Request->Id, Status);
966 IKsFilter_DispatchDeviceIoControl(
967 IN PDEVICE_OBJECT DeviceObject
,
970 PIO_STACK_LOCATION IoStack
;
972 IKsFilterImpl
* This
;
974 PKSFILTER FilterInstance
;
975 UNICODE_STRING GuidString
;
976 PKSPROPERTY Property
;
979 /* obtain filter from object header */
980 Status
= IKsFilter_GetFilterFromIrp(Irp
, &Filter
);
981 if (!NT_SUCCESS(Status
))
984 /* get our real implementation */
985 This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Header
.OuterUnknown
);
987 /* current irp stack */
988 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
990 /* get property from input buffer */
991 Property
= (PKSPROPERTY
)IoStack
->Parameters
.DeviceIoControl
.Type3InputBuffer
;
993 /* get filter instance */
994 FilterInstance
= Filter
->lpVtbl
->GetStruct(Filter
);
997 ASSERT(IoStack
->Parameters
.DeviceIoControl
.InputBufferLength
>= sizeof(KSIDENTIFIER
));
998 ASSERT(FilterInstance
);
999 ASSERT(FilterInstance
->Descriptor
);
1000 ASSERT(FilterInstance
->Descriptor
->AutomationTable
);
1002 /* acquire control mutex */
1003 KeWaitForSingleObject(This
->Header
.ControlMutex
, Executive
, KernelMode
, FALSE
, NULL
);
1005 if (IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_METHOD
)
1007 const KSMETHOD_SET
*MethodSet
= NULL
;
1008 ULONG MethodItemSize
= 0;
1010 /* check if the driver supports method sets */
1011 if (FilterInstance
->Descriptor
->AutomationTable
->MethodSetsCount
)
1013 SetCount
= FilterInstance
->Descriptor
->AutomationTable
->MethodSetsCount
;
1014 MethodSet
= FilterInstance
->Descriptor
->AutomationTable
->MethodSets
;
1015 MethodItemSize
= FilterInstance
->Descriptor
->AutomationTable
->MethodItemSize
;
1018 /* call method set handler */
1019 Status
= KspMethodHandlerWithAllocator(Irp
, SetCount
, MethodSet
, NULL
, MethodItemSize
);
1021 else if (IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_PROPERTY
)
1023 const KSPROPERTY_SET
*PropertySet
= NULL
;
1024 ULONG PropertyItemSize
= 0;
1026 /* check if the driver supports method sets */
1027 if (FilterInstance
->Descriptor
->AutomationTable
->PropertySetsCount
)
1029 SetCount
= FilterInstance
->Descriptor
->AutomationTable
->PropertySetsCount
;
1030 PropertySet
= FilterInstance
->Descriptor
->AutomationTable
->PropertySets
;
1031 PropertyItemSize
= FilterInstance
->Descriptor
->AutomationTable
->PropertyItemSize
;
1034 /* needed for our property handlers */
1035 KSPROPERTY_ITEM_IRP_STORAGE(Irp
) = (KSPROPERTY_ITEM
*)This
;
1037 /* call property handler */
1038 Status
= KspPropertyHandler(Irp
, SetCount
, PropertySet
, NULL
, PropertyItemSize
);
1043 ASSERT(IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_ENABLE_EVENT
||
1044 IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_DISABLE_EVENT
);
1046 if (IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_ENABLE_EVENT
)
1048 /* call enable event handlers */
1049 Status
= KspEnableEvent(Irp
,
1050 FilterInstance
->Descriptor
->AutomationTable
->EventSetsCount
,
1051 (PKSEVENT_SET
)FilterInstance
->Descriptor
->AutomationTable
->EventSets
,
1052 &This
->Header
.EventList
,
1054 (PVOID
)&This
->Header
.EventListLock
,
1056 FilterInstance
->Descriptor
->AutomationTable
->EventItemSize
);
1060 /* disable event handler */
1061 Status
= KsDisableEvent(Irp
, &This
->Header
.EventList
, KSEVENTS_SPINLOCK
, &This
->Header
.EventListLock
);
1065 RtlStringFromGUID(&Property
->Set
, &GuidString
);
1066 DPRINT("IKsFilter_DispatchDeviceIoControl property Set |%S| Id %u Flags %x Status %lx ResultLength %lu\n", GuidString
.Buffer
, Property
->Id
, Property
->Flags
, Status
, Irp
->IoStatus
.Information
);
1067 RtlFreeUnicodeString(&GuidString
);
1069 /* release filter */
1070 Filter
->lpVtbl
->Release(Filter
);
1072 /* release control mutex */
1073 KeReleaseMutex(This
->Header
.ControlMutex
, FALSE
);
1075 if (Status
!= STATUS_PENDING
)
1077 Irp
->IoStatus
.Status
= Status
;
1078 CompleteRequest(Irp
, IO_NO_INCREMENT
);
1085 static KSDISPATCH_TABLE DispatchTable
=
1087 IKsFilter_DispatchDeviceIoControl
,
1088 KsDispatchInvalidDeviceRequest
,
1089 KsDispatchInvalidDeviceRequest
,
1090 KsDispatchInvalidDeviceRequest
,
1091 IKsFilter_DispatchClose
,
1092 KsDispatchQuerySecurity
,
1093 KsDispatchSetSecurity
,
1094 KsDispatchFastIoDeviceControlFailure
,
1095 KsDispatchFastReadFailure
,
1096 KsDispatchFastReadFailure
,
1101 IKsFilter_CreateDescriptors(
1102 IKsFilterImpl
* This
,
1103 KSFILTER_DESCRIPTOR
* FilterDescriptor
)
1108 /* initialize pin descriptors */
1109 This
->FirstPin
= NULL
;
1110 This
->PinInstanceCount
= NULL
;
1111 This
->ProcessPinIndex
= NULL
;
1113 /* initialize topology descriptor */
1114 This
->Topology
.CategoriesCount
= FilterDescriptor
->CategoriesCount
;
1115 This
->Topology
.Categories
= FilterDescriptor
->Categories
;
1116 This
->Topology
.TopologyNodesCount
= FilterDescriptor
->NodeDescriptorsCount
;
1117 This
->Topology
.TopologyConnectionsCount
= FilterDescriptor
->ConnectionsCount
;
1118 This
->Topology
.TopologyConnections
= FilterDescriptor
->Connections
;
1120 /* are there any templates */
1121 if (FilterDescriptor
->PinDescriptorsCount
)
1124 ASSERT(FilterDescriptor
->PinDescriptors
);
1126 /* FIXME handle variable sized pin descriptors */
1127 ASSERT(FilterDescriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
1129 /* store pin descriptors ex */
1130 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->Filter
.Descriptor
->PinDescriptors
, FilterDescriptor
->PinDescriptorSize
* FilterDescriptor
->PinDescriptorsCount
,
1131 FilterDescriptor
->PinDescriptorSize
* FilterDescriptor
->PinDescriptorsCount
, 0);
1133 if (!NT_SUCCESS(Status
))
1135 DPRINT("IKsFilter_CreateDescriptors _KsEdit failed %lx\n", Status
);
1139 /* store pin instance count */
1140 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->PinInstanceCount
, sizeof(ULONG
) * FilterDescriptor
->PinDescriptorsCount
,
1141 sizeof(ULONG
) * FilterDescriptor
->PinDescriptorsCount
, 0);
1143 if (!NT_SUCCESS(Status
))
1145 DPRINT("IKsFilter_CreateDescriptors _KsEdit failed %lx\n", Status
);
1149 /* store instantiated pin arrays */
1150 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->FirstPin
, sizeof(PVOID
) * FilterDescriptor
->PinDescriptorsCount
,
1151 sizeof(PVOID
) * FilterDescriptor
->PinDescriptorsCount
, 0);
1153 if (!NT_SUCCESS(Status
))
1155 DPRINT("IKsFilter_CreateDescriptors _KsEdit failed %lx\n", Status
);
1159 /* add new pin factory */
1160 RtlMoveMemory((PVOID
)This
->Filter
.Descriptor
->PinDescriptors
, FilterDescriptor
->PinDescriptors
, FilterDescriptor
->PinDescriptorSize
* FilterDescriptor
->PinDescriptorsCount
);
1162 /* allocate process pin index */
1163 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->ProcessPinIndex
, sizeof(KSPROCESSPIN_INDEXENTRY
) * FilterDescriptor
->PinDescriptorsCount
,
1164 sizeof(KSPROCESSPIN_INDEXENTRY
) * FilterDescriptor
->PinDescriptorsCount
, 0);
1166 if (!NT_SUCCESS(Status
))
1168 DPRINT("IKsFilter_CreateDescriptors _KsEdit failed %lx\n", Status
);
1175 if (FilterDescriptor
->ConnectionsCount
)
1177 /* modify connections array */
1178 Status
= _KsEdit(This
->Filter
.Bag
,
1179 (PVOID
*)&This
->Filter
.Descriptor
->Connections
,
1180 FilterDescriptor
->ConnectionsCount
* sizeof(KSTOPOLOGY_CONNECTION
),
1181 FilterDescriptor
->ConnectionsCount
* sizeof(KSTOPOLOGY_CONNECTION
),
1184 This
->Topology
.TopologyConnections
= This
->Filter
.Descriptor
->Connections
;
1185 This
->Topology
.TopologyConnectionsCount
= ((PKSFILTER_DESCRIPTOR
)This
->Filter
.Descriptor
)->ConnectionsCount
= FilterDescriptor
->ConnectionsCount
;
1188 if (FilterDescriptor
->NodeDescriptorsCount
)
1191 ASSERT(FilterDescriptor
->NodeDescriptors
);
1193 /* FIXME handle variable sized node descriptors */
1194 ASSERT(FilterDescriptor
->NodeDescriptorSize
== sizeof(KSNODE_DESCRIPTOR
));
1196 This
->Topology
.TopologyNodes
= AllocateItem(NonPagedPool
, sizeof(GUID
) * FilterDescriptor
->NodeDescriptorsCount
);
1197 /* allocate topology node types array */
1198 if (!This
->Topology
.TopologyNodes
)
1200 DPRINT("IKsFilter_CreateDescriptors OutOfMemory TopologyNodesCount %lu\n", FilterDescriptor
->NodeDescriptorsCount
);
1201 return STATUS_INSUFFICIENT_RESOURCES
;
1204 This
->Topology
.TopologyNodesNames
= AllocateItem(NonPagedPool
, sizeof(GUID
) * FilterDescriptor
->NodeDescriptorsCount
);
1205 /* allocate topology names array */
1206 if (!This
->Topology
.TopologyNodesNames
)
1208 FreeItem((PVOID
)This
->Topology
.TopologyNodes
);
1209 DPRINT("IKsFilter_CreateDescriptors OutOfMemory TopologyNodesCount %lu\n", FilterDescriptor
->NodeDescriptorsCount
);
1210 return STATUS_INSUFFICIENT_RESOURCES
;
1213 DPRINT("NodeDescriptorCount %lu\n", FilterDescriptor
->NodeDescriptorsCount
);
1214 for(Index
= 0; Index
< FilterDescriptor
->NodeDescriptorsCount
; Index
++)
1216 DPRINT("Index %lu Type %p Name %p\n", Index
, FilterDescriptor
->NodeDescriptors
[Index
].Type
, FilterDescriptor
->NodeDescriptors
[Index
].Name
);
1218 /* copy topology type */
1219 if (FilterDescriptor
->NodeDescriptors
[Index
].Type
)
1220 RtlMoveMemory((PVOID
)&This
->Topology
.TopologyNodes
[Index
], FilterDescriptor
->NodeDescriptors
[Index
].Type
, sizeof(GUID
));
1222 /* copy topology name */
1223 if (FilterDescriptor
->NodeDescriptors
[Index
].Name
)
1224 RtlMoveMemory((PVOID
)&This
->Topology
.TopologyNodesNames
[Index
], FilterDescriptor
->NodeDescriptors
[Index
].Name
, sizeof(GUID
));
1228 return STATUS_SUCCESS
;
1232 IKsFilter_CopyFilterDescriptor(
1233 IKsFilterImpl
* This
,
1234 const KSFILTER_DESCRIPTOR
* FilterDescriptor
)
1237 KSAUTOMATION_TABLE AutomationTable
;
1239 This
->Filter
.Descriptor
= AllocateItem(NonPagedPool
, sizeof(KSFILTER_DESCRIPTOR
));
1240 if (!This
->Filter
.Descriptor
)
1241 return STATUS_INSUFFICIENT_RESOURCES
;
1243 Status
= KsAddItemToObjectBag(This
->Filter
.Bag
, (PVOID
)This
->Filter
.Descriptor
, NULL
);
1244 if (!NT_SUCCESS(Status
))
1246 FreeItem((PVOID
)This
->Filter
.Descriptor
);
1247 This
->Filter
.Descriptor
= NULL
;
1248 return STATUS_INSUFFICIENT_RESOURCES
;
1251 /* copy filter descriptor fields */
1252 RtlMoveMemory((PVOID
)This
->Filter
.Descriptor
, FilterDescriptor
, sizeof(KSFILTER_DESCRIPTOR
));
1254 /* zero automation table */
1255 RtlZeroMemory(&AutomationTable
, sizeof(KSAUTOMATION_TABLE
));
1257 /* setup filter property sets */
1258 AutomationTable
.PropertyItemSize
= sizeof(KSPROPERTY_ITEM
);
1259 AutomationTable
.PropertySetsCount
= 2;
1260 AutomationTable
.PropertySets
= FilterPropertySet
;
1262 /* merge filter automation table */
1263 Status
= KsMergeAutomationTables((PKSAUTOMATION_TABLE
*)&This
->Filter
.Descriptor
->AutomationTable
, (PKSAUTOMATION_TABLE
)FilterDescriptor
->AutomationTable
, &AutomationTable
, This
->Filter
.Bag
);
1274 PKSPIN NextPin
, CurPin
;
1275 PKSBASIC_HEADER BasicHeader
;
1276 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1279 ASSERT(Pin
->Id
< This
->Filter
.Descriptor
->PinDescriptorsCount
);
1281 if (This
->FirstPin
[Pin
->Id
] == NULL
)
1283 /* welcome first pin */
1284 This
->FirstPin
[Pin
->Id
] = Pin
;
1285 This
->PinInstanceCount
[Pin
->Id
]++;
1290 CurPin
= This
->FirstPin
[Pin
->Id
];
1294 /* get next instantiated pin */
1295 NextPin
= KsPinGetNextSiblingPin(CurPin
);
1301 }while(NextPin
!= NULL
);
1303 /* get basic header */
1304 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)CurPin
- sizeof(KSBASIC_HEADER
));
1307 BasicHeader
->Next
.Pin
= Pin
;
1311 IKsFilter_RemovePin(
1315 PKSPIN NextPin
, CurPin
, LastPin
;
1316 PKSBASIC_HEADER BasicHeader
;
1317 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1320 ASSERT(Pin
->Id
< This
->Filter
.Descriptor
->PinDescriptorsCount
);
1323 CurPin
= This
->FirstPin
[Pin
->Id
];
1328 /* get next instantiated pin */
1329 NextPin
= KsPinGetNextSiblingPin(CurPin
);
1335 /* get basic header of last pin */
1336 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)LastPin
- sizeof(KSBASIC_HEADER
));
1338 BasicHeader
->Next
.Pin
= NextPin
;
1342 /* erase last pin */
1343 This
->FirstPin
[Pin
->Id
] = NextPin
;
1345 /* decrement pin instance count */
1346 This
->PinInstanceCount
[Pin
->Id
]--;
1356 }while(NextPin
!= NULL
);
1365 IKsFilter_DispatchCreatePin(
1366 IN PDEVICE_OBJECT DeviceObject
,
1369 IKsFilterImpl
* This
;
1370 PKSOBJECT_CREATE_ITEM CreateItem
;
1371 PKSPIN_CONNECT Connect
;
1374 DPRINT("IKsFilter_DispatchCreatePin\n");
1376 /* get the create item */
1377 CreateItem
= KSCREATE_ITEM_IRP_STORAGE(Irp
);
1379 /* get the filter object */
1380 This
= (IKsFilterImpl
*)CreateItem
->Context
;
1383 ASSERT(This
->Header
.Type
== KsObjectTypeFilter
);
1385 /* acquire control mutex */
1386 KeWaitForSingleObject(This
->Header
.ControlMutex
, Executive
, KernelMode
, FALSE
, NULL
);
1388 /* now validate the connect request */
1389 Status
= KspValidateConnectRequest(Irp
, This
->Filter
.Descriptor
->PinDescriptorsCount
, (PVOID
)This
->Filter
.Descriptor
->PinDescriptors
, This
->Filter
.Descriptor
->PinDescriptorSize
, &Connect
);
1391 DPRINT("IKsFilter_DispatchCreatePin KsValidateConnectRequest %lx\n", Status
);
1393 if (NT_SUCCESS(Status
))
1396 ASSERT(Connect
->PinId
< This
->Filter
.Descriptor
->PinDescriptorsCount
);
1398 DPRINT("IKsFilter_DispatchCreatePin KsValidateConnectRequest PinId %lu CurrentInstanceCount %lu MaxPossible %lu\n", Connect
->PinId
,
1399 This
->PinInstanceCount
[Connect
->PinId
],
1400 This
->Filter
.Descriptor
->PinDescriptors
[Connect
->PinId
].InstancesPossible
);
1402 if (This
->PinInstanceCount
[Connect
->PinId
] < This
->Filter
.Descriptor
->PinDescriptors
[Connect
->PinId
].InstancesPossible
)
1404 /* create the pin */
1405 Status
= KspCreatePin(DeviceObject
, Irp
, This
->Header
.KsDevice
, This
->FilterFactory
, (IKsFilter
*)&This
->Header
.OuterUnknown
, Connect
, (KSPIN_DESCRIPTOR_EX
*)&This
->Filter
.Descriptor
->PinDescriptors
[Connect
->PinId
]);
1407 DPRINT("IKsFilter_DispatchCreatePin KspCreatePin %lx\n", Status
);
1411 /* maximum instance count reached, bye-bye */
1412 Status
= STATUS_UNSUCCESSFUL
;
1413 DPRINT("IKsFilter_DispatchCreatePin MaxInstance %lu CurInstance %lu %lx\n", This
->Filter
.Descriptor
->PinDescriptors
[Connect
->PinId
].InstancesPossible
, This
->PinInstanceCount
[Connect
->PinId
]);
1417 /* release control mutex */
1418 KeReleaseMutex(This
->Header
.ControlMutex
, FALSE
);
1420 if (Status
!= STATUS_PENDING
)
1422 /* complete request */
1423 Irp
->IoStatus
.Status
= Status
;
1424 CompleteRequest(Irp
, IO_NO_INCREMENT
);
1428 DPRINT("IKsFilter_DispatchCreatePin Result %lx\n", Status
);
1434 IKsFilter_DispatchCreateNode(
1435 IN PDEVICE_OBJECT DeviceObject
,
1439 Irp
->IoStatus
.Status
= STATUS_UNSUCCESSFUL
;
1440 CompleteRequest(Irp
, IO_NO_INCREMENT
);
1441 return STATUS_UNSUCCESSFUL
;
1446 IKsFilter_AttachFilterToFilterFactory(
1447 IKsFilterImpl
* This
,
1448 PKSFILTERFACTORY FilterFactory
)
1450 PKSBASIC_HEADER BasicHeader
;
1454 /* get filter factory basic header */
1455 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)FilterFactory
- sizeof(KSBASIC_HEADER
));
1458 ASSERT(BasicHeader
->Type
== KsObjectTypeFilterFactory
);
1460 if (BasicHeader
->FirstChild
.FilterFactory
== NULL
)
1462 /* welcome first instantiated filter */
1463 BasicHeader
->FirstChild
.Filter
= &This
->Filter
;
1467 /* set to first entry */
1468 Filter
= BasicHeader
->FirstChild
.Filter
;
1472 /* get basic header */
1473 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)Filter
- sizeof(KSBASIC_HEADER
));
1475 ASSERT(BasicHeader
->Type
== KsObjectTypeFilter
);
1477 if (BasicHeader
->Next
.Filter
)
1479 /* iterate to next filter factory */
1480 Filter
= BasicHeader
->Next
.Filter
;
1484 /* found last entry */
1489 /* attach filter factory */
1490 BasicHeader
->Next
.Filter
= &This
->Filter
;
1494 IKsFilter_RemoveFilterFromFilterFactory(
1495 IKsFilterImpl
* This
,
1496 PKSFILTERFACTORY FilterFactory
)
1498 PKSBASIC_HEADER BasicHeader
;
1499 PKSFILTER Filter
, LastFilter
;
1501 /* get filter factory basic header */
1502 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)FilterFactory
- sizeof(KSBASIC_HEADER
));
1505 ASSERT(BasicHeader
->Type
== KsObjectTypeFilterFactory
);
1506 ASSERT(BasicHeader
->FirstChild
.Filter
!= NULL
);
1509 /* set to first entry */
1510 Filter
= BasicHeader
->FirstChild
.Filter
;
1515 if (Filter
== &This
->Filter
)
1519 /* get basic header */
1520 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)LastFilter
- sizeof(KSBASIC_HEADER
));
1521 /* remove filter instance */
1522 BasicHeader
->Next
.Filter
= This
->Header
.Next
.Filter
;
1527 /* remove filter instance */
1528 BasicHeader
->FirstChild
.Filter
= This
->Header
.Next
.Filter
;
1533 /* get basic header */
1534 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)Filter
- sizeof(KSBASIC_HEADER
));
1536 ASSERT(BasicHeader
->Type
== KsObjectTypeFilter
);
1538 LastFilter
= Filter
;
1539 if (BasicHeader
->Next
.Filter
)
1541 /* iterate to next filter factory */
1542 Filter
= BasicHeader
->Next
.Filter
;
1546 /* filter is not in list */
1555 IKsFilter_FilterCentricWorker(
1558 IKsProcessingObject
* Object
= (IKsProcessingObject
*)Ctx
;
1564 Object
->lpVtbl
->ProcessingObjectWork(Object
);
1570 IN PDEVICE_OBJECT DeviceObject
,
1572 IN IKsFilterFactory
*iface
)
1574 IKsFilterImpl
* This
;
1575 IKsDevice
*KsDevice
;
1576 PKSFILTERFACTORY Factory
;
1577 PIO_STACK_LOCATION IoStack
;
1578 PDEVICE_EXTENSION DeviceExtension
;
1580 PKSOBJECT_CREATE_ITEM CreateItem
;
1582 /* get device extension */
1583 DeviceExtension
= (PDEVICE_EXTENSION
)DeviceObject
->DeviceExtension
;
1585 /* get the filter factory */
1586 Factory
= iface
->lpVtbl
->GetStruct(iface
);
1588 if (!Factory
|| !Factory
->FilterDescriptor
)
1590 /* Sorry it just will not work */
1591 return STATUS_UNSUCCESSFUL
;
1594 if (Factory
->FilterDescriptor
->Flags
& KSFILTER_FLAG_DENY_USERMODE_ACCESS
)
1596 if (Irp
->RequestorMode
== UserMode
)
1598 /* filter not accessible from user mode */
1599 DPRINT1("Access denied\n");
1600 return STATUS_UNSUCCESSFUL
;
1604 /* allocate filter instance */
1605 This
= AllocateItem(NonPagedPool
, sizeof(IKsFilterImpl
));
1608 DPRINT1("KspCreateFilter OutOfMemory\n");
1609 return STATUS_INSUFFICIENT_RESOURCES
;
1612 /* initialize object bag */
1613 This
->Filter
.Bag
= AllocateItem(NonPagedPool
, sizeof(KSIOBJECT_BAG
));
1614 if (!This
->Filter
.Bag
)
1618 DPRINT1("KspCreateFilter OutOfMemory\n");
1619 return STATUS_INSUFFICIENT_RESOURCES
;
1621 KsDevice
= (IKsDevice
*)&DeviceExtension
->DeviceHeader
->BasicHeader
.OuterUnknown
;
1622 KsDevice
->lpVtbl
->InitializeObjectBag(KsDevice
, (PKSIOBJECT_BAG
)This
->Filter
.Bag
, NULL
);
1624 /* copy filter descriptor */
1625 Status
= IKsFilter_CopyFilterDescriptor(This
, Factory
->FilterDescriptor
);
1626 if (!NT_SUCCESS(Status
))
1628 /* not enough memory */
1629 FreeItem(This
->Filter
.Bag
);
1631 DPRINT("KspCreateFilter IKsFilter_CopyFilterDescriptor failed %lx\n", Status
);
1632 return STATUS_INSUFFICIENT_RESOURCES
;
1635 /* get current irp stack */
1636 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
1638 /* allocate create items */
1639 CreateItem
= AllocateItem(NonPagedPool
, sizeof(KSOBJECT_CREATE_ITEM
) * 2);
1643 FreeItem(This
->Filter
.Bag
);
1645 DPRINT1("KspCreateFilter OutOfMemory\n");
1646 return STATUS_INSUFFICIENT_RESOURCES
;
1649 /* initialize pin create item */
1650 CreateItem
[0].Create
= IKsFilter_DispatchCreatePin
;
1651 CreateItem
[0].Context
= (PVOID
)This
;
1652 CreateItem
[0].Flags
= KSCREATE_ITEM_FREEONSTOP
;
1653 RtlInitUnicodeString(&CreateItem
[0].ObjectClass
, KSSTRING_Pin
);
1654 /* initialize node create item */
1655 CreateItem
[1].Create
= IKsFilter_DispatchCreateNode
;
1656 CreateItem
[1].Context
= (PVOID
)This
;
1657 CreateItem
[1].Flags
= KSCREATE_ITEM_FREEONSTOP
;
1658 RtlInitUnicodeString(&CreateItem
[1].ObjectClass
, KSSTRING_TopologyNode
);
1661 /* initialize filter instance */
1663 This
->Header
.OuterUnknown
= (PUNKNOWN
)&vt_IKsFilter
;
1664 This
->lpVtblKsControl
= &vt_IKsControl
;
1665 This
->lpVtblKsProcessingObject
= &vt_IKsProcessingObject
;
1667 This
->Factory
= Factory
;
1668 This
->FilterFactory
= iface
;
1669 This
->FileObject
= IoStack
->FileObject
;
1670 KeInitializeMutex(&This
->ProcessingMutex
, 0);
1672 /* initialize basic header */
1673 This
->Header
.KsDevice
= &DeviceExtension
->DeviceHeader
->KsDevice
;
1674 This
->Header
.Parent
.KsFilterFactory
= iface
->lpVtbl
->GetStruct(iface
);
1675 This
->Header
.Type
= KsObjectTypeFilter
;
1676 This
->Header
.ControlMutex
= &This
->ControlMutex
;
1677 KeInitializeMutex(This
->Header
.ControlMutex
, 0);
1678 InitializeListHead(&This
->Header
.EventList
);
1679 KeInitializeSpinLock(&This
->Header
.EventListLock
);
1681 /* initialize and gate */
1682 KsGateInitializeAnd(&This
->Gate
, NULL
);
1684 /* FIXME initialize and gate based on pin flags */
1686 /* initialize work item */
1687 ExInitializeWorkItem(&This
->WorkItem
, IKsFilter_FilterCentricWorker
, (PVOID
)This
->lpVtblKsProcessingObject
);
1689 /* allocate counted work item */
1690 Status
= KsRegisterCountedWorker(HyperCriticalWorkQueue
, &This
->WorkItem
, &This
->Worker
);
1691 if (!NT_SUCCESS(Status
))
1693 /* what can go wrong, goes wrong */
1694 DPRINT1("KsRegisterCountedWorker failed with %lx\n", Status
);
1696 FreeItem(CreateItem
);
1700 /* allocate the stream descriptors */
1701 Status
= IKsFilter_CreateDescriptors(This
, (PKSFILTER_DESCRIPTOR
)Factory
->FilterDescriptor
);
1702 if (!NT_SUCCESS(Status
))
1704 /* what can go wrong, goes wrong */
1705 DPRINT1("IKsFilter_CreateDescriptors failed with %lx\n", Status
);
1706 KsUnregisterWorker(This
->Worker
);
1708 FreeItem(CreateItem
);
1714 /* does the filter have a filter dispatch */
1715 if (Factory
->FilterDescriptor
->Dispatch
)
1717 /* does it have a create routine */
1718 if (Factory
->FilterDescriptor
->Dispatch
->Create
)
1720 /* now let driver initialize the filter instance */
1722 ASSERT(This
->Header
.KsDevice
);
1723 ASSERT(This
->Header
.KsDevice
->Started
);
1724 Status
= Factory
->FilterDescriptor
->Dispatch
->Create(&This
->Filter
, Irp
);
1726 if (!NT_SUCCESS(Status
) && Status
!= STATUS_PENDING
)
1728 /* driver failed to initialize */
1729 DPRINT1("Driver: Status %x\n", Status
);
1731 /* free filter instance */
1732 KsUnregisterWorker(This
->Worker
);
1734 FreeItem(CreateItem
);
1740 /* now allocate the object header */
1741 Status
= KsAllocateObjectHeader((PVOID
*)&This
->ObjectHeader
, 2, CreateItem
, Irp
, &DispatchTable
);
1742 if (!NT_SUCCESS(Status
))
1744 /* failed to allocate object header */
1745 DPRINT1("Failed to allocate object header %x\n", Status
);
1750 /* initialize object header extra fields */
1751 This
->ObjectHeader
->Type
= KsObjectTypeFilter
;
1752 This
->ObjectHeader
->Unknown
= (PUNKNOWN
)&This
->Header
.OuterUnknown
;
1753 This
->ObjectHeader
->ObjectType
= (PVOID
)&This
->Filter
;
1755 /* attach filter to filter factory */
1756 IKsFilter_AttachFilterToFilterFactory(This
, This
->Header
.Parent
.KsFilterFactory
);
1758 /* completed initialization */
1759 DPRINT1("KspCreateFilter done %lx KsDevice %p\n", Status
, This
->Header
.KsDevice
);
1769 KsFilterAcquireProcessingMutex(
1770 IN PKSFILTER Filter
)
1772 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1774 KeWaitForSingleObject(&This
->ProcessingMutex
, Executive
, KernelMode
, FALSE
, NULL
);
1783 KsFilterReleaseProcessingMutex(
1784 IN PKSFILTER Filter
)
1786 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1788 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
1798 KsFilterAddTopologyConnections (
1799 IN PKSFILTER Filter
,
1800 IN ULONG NewConnectionsCount
,
1801 IN
const KSTOPOLOGY_CONNECTION
*const NewTopologyConnections
)
1805 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1807 DPRINT("KsFilterAddTopologyConnections\n");
1809 ASSERT(This
->Filter
.Descriptor
);
1810 Count
= This
->Filter
.Descriptor
->ConnectionsCount
+ NewConnectionsCount
;
1813 /* modify connections array */
1814 Status
= _KsEdit(This
->Filter
.Bag
,
1815 (PVOID
*)&This
->Filter
.Descriptor
->Connections
,
1816 Count
* sizeof(KSTOPOLOGY_CONNECTION
),
1817 This
->Filter
.Descriptor
->ConnectionsCount
* sizeof(KSTOPOLOGY_CONNECTION
),
1820 if (!NT_SUCCESS(Status
))
1823 DPRINT("KsFilterAddTopologyConnections KsEdit failed with %lx\n", Status
);
1827 /* FIXME verify connections */
1829 /* copy new connections */
1830 RtlMoveMemory((PVOID
)&This
->Filter
.Descriptor
->Connections
[This
->Filter
.Descriptor
->ConnectionsCount
],
1831 NewTopologyConnections
,
1832 NewConnectionsCount
* sizeof(KSTOPOLOGY_CONNECTION
));
1834 /* update topology */
1835 This
->Topology
.TopologyConnectionsCount
+= NewConnectionsCount
;
1836 ((PKSFILTER_DESCRIPTOR
)This
->Filter
.Descriptor
)->ConnectionsCount
+= NewConnectionsCount
;
1837 This
->Topology
.TopologyConnections
= This
->Filter
.Descriptor
->Connections
;
1848 KsFilterAttemptProcessing(
1849 IN PKSFILTER Filter
,
1850 IN BOOLEAN Asynchronous
)
1853 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1856 Gate
= This
->lpVtblKsProcessingObject
->GetAndGate((IKsProcessingObject
*)This
->lpVtblKsProcessingObject
);
1858 if (!KsGateCaptureThreshold(Gate
))
1860 /* filter control gate is closed */
1863 DPRINT1("processing\n");
1864 /* try initiate processing */
1865 This
->lpVtblKsProcessingObject
->Process((IKsProcessingObject
*)This
->lpVtblKsProcessingObject
, Asynchronous
);
1874 KsFilterCreateNode (
1875 IN PKSFILTER Filter
,
1876 IN
const KSNODE_DESCRIPTOR
*const NodeDescriptor
,
1880 return STATUS_NOT_IMPLEMENTED
;
1889 KsFilterCreatePinFactory (
1890 IN PKSFILTER Filter
,
1891 IN
const KSPIN_DESCRIPTOR_EX
*const InPinDescriptor
,
1896 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1898 DPRINT("KsFilterCreatePinFactory\n");
1900 /* calculate new count */
1901 Count
= This
->Filter
.Descriptor
->PinDescriptorsCount
+ 1;
1904 ASSERT(This
->Filter
.Descriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
1906 /* modify pin descriptors ex array */
1907 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->Filter
.Descriptor
->PinDescriptors
, Count
* This
->Filter
.Descriptor
->PinDescriptorSize
, This
->Filter
.Descriptor
->PinDescriptorsCount
* This
->Filter
.Descriptor
->PinDescriptorSize
, 0);
1908 if (!NT_SUCCESS(Status
))
1911 DPRINT("KsFilterCreatePinFactory _KsEdit failed with %lx\n", Status
);
1915 /* modify pin instance count array */
1916 Status
= _KsEdit(This
->Filter
.Bag
,(PVOID
*)&This
->PinInstanceCount
, sizeof(ULONG
) * Count
, sizeof(ULONG
) * This
->Filter
.Descriptor
->PinDescriptorsCount
, 0);
1917 if (!NT_SUCCESS(Status
))
1920 DPRINT("KsFilterCreatePinFactory _KsEdit failed with %lx\n", Status
);
1924 /* modify first pin array */
1925 Status
= _KsEdit(This
->Filter
.Bag
,(PVOID
*)&This
->FirstPin
, sizeof(PVOID
) * Count
, sizeof(PVOID
) * This
->Filter
.Descriptor
->PinDescriptorsCount
, 0);
1926 if (!NT_SUCCESS(Status
))
1929 DPRINT("KsFilterCreatePinFactory _KsEdit failed with %lx\n", Status
);
1933 /* add new pin factory */
1934 RtlMoveMemory((PVOID
)&This
->Filter
.Descriptor
->PinDescriptors
[This
->Filter
.Descriptor
->PinDescriptorsCount
], InPinDescriptor
, sizeof(KSPIN_DESCRIPTOR_EX
));
1936 /* allocate process pin index */
1937 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->ProcessPinIndex
, sizeof(KSPROCESSPIN_INDEXENTRY
) * Count
,
1938 sizeof(KSPROCESSPIN_INDEXENTRY
) * This
->Filter
.Descriptor
->PinDescriptorsCount
, 0);
1940 if (!NT_SUCCESS(Status
))
1942 DPRINT("KsFilterCreatePinFactory _KsEdit failed %lx\n", Status
);
1946 /* store new pin id */
1947 *PinID
= This
->Filter
.Descriptor
->PinDescriptorsCount
;
1949 /* increment pin descriptor count */
1950 ((PKSFILTER_DESCRIPTOR
)This
->Filter
.Descriptor
)->PinDescriptorsCount
++;
1953 DPRINT("KsFilterCreatePinFactory done\n");
1954 return STATUS_SUCCESS
;
1965 IN PKSFILTER Filter
)
1967 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1969 /* return and-gate */
1979 KsFilterGetChildPinCount(
1980 IN PKSFILTER Filter
,
1983 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1985 if (PinId
>= This
->Filter
.Descriptor
->PinDescriptorsCount
)
1987 /* index is out of bounds */
1990 /* return pin instance count */
1991 return This
->PinInstanceCount
[PinId
];
2000 KsFilterGetFirstChildPin(
2001 IN PKSFILTER Filter
,
2004 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
2006 if (PinId
>= This
->Filter
.Descriptor
->PinDescriptorsCount
)
2008 /* index is out of bounds */
2012 /* return first pin index */
2013 return This
->FirstPin
[PinId
];
2022 KsFilterRegisterPowerCallbacks(
2023 IN PKSFILTER Filter
,
2024 IN PFNKSFILTERPOWER Sleep OPTIONAL
,
2025 IN PFNKSFILTERPOWER Wake OPTIONAL
)
2027 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
2029 This
->Sleep
= Sleep
;
2042 PIO_STACK_LOCATION IoStack
;
2043 PKSIOBJECT_HEADER ObjectHeader
;
2045 DPRINT("KsGetFilterFromIrp\n");
2047 /* get current irp stack location */
2048 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
2051 ASSERT(IoStack
->FileObject
);
2053 /* get object header */
2054 ObjectHeader
= (PKSIOBJECT_HEADER
)IoStack
->FileObject
->FsContext2
;
2056 if (ObjectHeader
->Type
== KsObjectTypeFilter
)
2058 /* irp is targeted at the filter */
2059 return (PKSFILTER
)ObjectHeader
->ObjectType
;
2061 else if (ObjectHeader
->Type
== KsObjectTypePin
)
2063 /* irp is for a pin */
2064 return KsPinGetParentFilter((PKSPIN
)ObjectHeader
->ObjectType
);
2068 /* irp is unappropiate to retrieve a filter */