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
16 KSBASIC_HEADER Header
;
19 IKsControlVtbl
*lpVtblKsControl
;
20 IKsFilterFactory
* FilterFactory
;
21 IKsProcessingObjectVtbl
* lpVtblKsProcessingObject
;
24 PKSIOBJECT_HEADER ObjectHeader
;
26 PKSFILTERFACTORY Factory
;
27 PFILE_OBJECT FileObject
;
29 KMUTEX ProcessingMutex
;
32 WORK_QUEUE_ITEM WorkItem
;
35 PFNKSFILTERPOWER Sleep
;
36 PFNKSFILTERPOWER Wake
;
38 ULONG
*PinInstanceCount
;
40 PKSPROCESSPIN_INDEXENTRY ProcessPinIndex
;
44 const GUID IID_IKsControl
= {0x28F54685L
, 0x06FD, 0x11D2, {0xB2, 0x7A, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96}};
45 const GUID IID_IKsFilter
= {0x3ef6ee44L
, 0x0D41, 0x11d2, {0xbe, 0xDA, 0x00, 0xc0, 0x4f, 0x8e, 0xF4, 0x57}};
46 const GUID KSPROPSETID_Topology
= {0x720D4AC0L
, 0x7533, 0x11D0, {0xA5, 0xD6, 0x28, 0xDB, 0x04, 0xC1, 0x00, 0x00}};
47 const GUID KSPROPSETID_Pin
= {0x8C134960L
, 0x51AD, 0x11CF, {0x87, 0x8A, 0x94, 0xF8, 0x01, 0xC1, 0x00, 0x00}};
48 const GUID KSPROPSETID_General
= {0x1464EDA5L
, 0x6A8F, 0x11D1, {0x9A, 0xA7, 0x00, 0xA0, 0xC9, 0x22, 0x31, 0x96}};
51 IKsFilter_RemoveFilterFromFilterFactory(
53 PKSFILTERFACTORY FilterFactory
);
55 NTSTATUS NTAPI
FilterTopologyPropertyHandler(IN PIRP Irp
, IN PKSIDENTIFIER Request
, IN OUT PVOID Data
);
56 NTSTATUS NTAPI
FilterPinPropertyHandler(IN PIRP Irp
, IN PKSIDENTIFIER Request
, IN OUT PVOID Data
);
57 NTSTATUS NTAPI
FilterGeneralComponentIdHandler(IN PIRP Irp
, IN PKSIDENTIFIER Request
, IN OUT PVOID Data
);
59 DEFINE_KSPROPERTY_TOPOLOGYSET(IKsFilterTopologySet
, FilterTopologyPropertyHandler
);
60 DEFINE_KSPROPERTY_PINPROPOSEDATAFORMAT(IKsFilterPinSet
, FilterPinPropertyHandler
, FilterPinPropertyHandler
, FilterPinPropertyHandler
);
61 DEFINE_KSPROPERTY_GENEREAL_COMPONENTID(IKsFilterGeneralSet
, FilterGeneralComponentIdHandler
);
63 KSPROPERTY_SET FilterPropertySet
[] =
66 &KSPROPSETID_Topology
,
67 sizeof(IKsFilterTopologySet
) / sizeof(KSPROPERTY_ITEM
),
68 (const KSPROPERTY_ITEM
*)&IKsFilterTopologySet
,
74 sizeof(IKsFilterPinSet
) / sizeof(KSPROPERTY_ITEM
),
75 (const KSPROPERTY_ITEM
*)&IKsFilterPinSet
,
81 sizeof(IKsFilterGeneralSet
) / sizeof(KSPROPERTY_ITEM
),
82 (const KSPROPERTY_ITEM
*)&IKsFilterGeneralSet
,
90 IKsProcessingObject_fnQueryInterface(
91 IKsProcessingObject
* iface
,
95 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
97 if (IsEqualGUIDAligned(refiid
, &IID_IUnknown
))
99 *Output
= &This
->Header
.OuterUnknown
;
100 _InterlockedIncrement(&This
->ref
);
101 return STATUS_SUCCESS
;
103 return STATUS_UNSUCCESSFUL
;
108 IKsProcessingObject_fnAddRef(
109 IKsProcessingObject
* iface
)
111 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
113 return InterlockedIncrement(&This
->ref
);
118 IKsProcessingObject_fnRelease(
119 IKsProcessingObject
* iface
)
121 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
123 InterlockedDecrement(&This
->ref
);
125 /* Return new reference count */
131 IKsProcessingObject_fnProcessingObjectWork(
132 IKsProcessingObject
* iface
)
135 LARGE_INTEGER TimeOut
;
136 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
138 DPRINT1("processing object\n");
139 /* first check if running at passive level */
140 if (KeGetCurrentIrql() == PASSIVE_LEVEL
)
142 /* acquire processing mutex */
143 KeWaitForSingleObject(&This
->ControlMutex
, Executive
, KernelMode
, FALSE
, NULL
);
147 /* dispatch level processing */
148 if (KeReadStateMutex(&This
->ControlMutex
) == 0)
150 /* some thread was faster */
151 DPRINT1("processing object too slow\n");
155 /* acquire processing mutex */
156 TimeOut
.QuadPart
= 0LL;
157 Status
= KeWaitForSingleObject(&This
->ControlMutex
, Executive
, KernelMode
, FALSE
, &TimeOut
);
159 if (Status
== STATUS_TIMEOUT
)
161 /* some thread was faster */
162 DPRINT1("processing object too slow\n");
170 /* check if the and-gate has been enabled again */
171 if (&This
->Gate
.Count
!= 0)
174 DPRINT1("processing object gate open\n");
178 DPRINT1("IKsProcessingObject_fnProcessingObjectWork not implemented\n");
183 /* release process mutex */
184 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
189 IKsProcessingObject_fnGetAndGate(
190 IKsProcessingObject
* iface
)
192 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
194 /* return and gate */
200 IKsProcessingObject_fnProcess(
201 IKsProcessingObject
* iface
,
202 IN BOOLEAN Asynchronous
)
204 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
206 /* should the action be asynchronous */
209 /* queue work item */
210 KsQueueWorkItem(This
->Worker
, &This
->WorkItem
);
211 DPRINT1("queueing\n");
216 /* does the filter require explicit deferred processing */
217 if ((This
->Filter
.Descriptor
->Flags
& (KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING
| KSFILTER_FLAG_CRITICAL_PROCESSING
| KSFILTER_FLAG_HYPERCRITICAL_PROCESSING
)) &&
218 KeGetCurrentIrql() > PASSIVE_LEVEL
)
220 /* queue work item */
221 KsQueueWorkItem(This
->Worker
, &This
->WorkItem
);
222 DPRINT1("queueing\n");
227 /* call worker routine directly */
228 iface
->lpVtbl
->ProcessingObjectWork(iface
);
233 IKsProcessingObject_fnReset(
234 IKsProcessingObject
* iface
)
236 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsProcessingObject
);
238 /* acquire processing mutex */
239 KeWaitForSingleObject(&This
->ProcessingMutex
, Executive
, KernelMode
, FALSE
, NULL
);
241 /* check if the filter supports dispatch routines */
242 if (This
->Filter
.Descriptor
->Dispatch
)
244 /* has the filter a reset routine */
245 if (This
->Filter
.Descriptor
->Dispatch
->Reset
)
248 This
->Filter
.Descriptor
->Dispatch
->Reset(&This
->Filter
);
252 /* release process mutex */
253 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
258 IKsProcessingObject_fnTriggerNotification(
259 IKsProcessingObject
* iface
)
264 static IKsProcessingObjectVtbl vt_IKsProcessingObject
=
266 IKsProcessingObject_fnQueryInterface
,
267 IKsProcessingObject_fnAddRef
,
268 IKsProcessingObject_fnRelease
,
269 IKsProcessingObject_fnProcessingObjectWork
,
270 IKsProcessingObject_fnGetAndGate
,
271 IKsProcessingObject_fnProcess
,
272 IKsProcessingObject_fnReset
,
273 IKsProcessingObject_fnTriggerNotification
277 //---------------------------------------------------------------------------------------------------------
280 IKsControl_fnQueryInterface(
285 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
287 if (IsEqualGUIDAligned(refiid
, &IID_IUnknown
))
289 *Output
= &This
->Header
.OuterUnknown
;
290 _InterlockedIncrement(&This
->ref
);
291 return STATUS_SUCCESS
;
293 return STATUS_UNSUCCESSFUL
;
301 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
303 return InterlockedIncrement(&This
->ref
);
308 IKsControl_fnRelease(
311 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
313 InterlockedDecrement(&This
->ref
);
315 /* Return new reference count */
321 IKsControl_fnKsProperty(
323 IN PKSPROPERTY Property
,
324 IN ULONG PropertyLength
,
325 IN OUT PVOID PropertyData
,
327 OUT ULONG
* BytesReturned
)
329 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
331 return KsSynchronousIoControlDevice(This
->FileObject
, KernelMode
, IOCTL_KS_PROPERTY
, Property
, PropertyLength
, PropertyData
, DataLength
, BytesReturned
);
337 IKsControl_fnKsMethod(
340 IN ULONG MethodLength
,
341 IN OUT PVOID MethodData
,
343 OUT ULONG
* BytesReturned
)
345 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
347 return KsSynchronousIoControlDevice(This
->FileObject
, KernelMode
, IOCTL_KS_METHOD
, Method
, MethodLength
, MethodData
, DataLength
, BytesReturned
);
353 IKsControl_fnKsEvent(
355 IN PKSEVENT Event OPTIONAL
,
356 IN ULONG EventLength
,
357 IN OUT PVOID EventData
,
359 OUT ULONG
* BytesReturned
)
361 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, lpVtblKsControl
);
365 return KsSynchronousIoControlDevice(This
->FileObject
, KernelMode
, IOCTL_KS_ENABLE_EVENT
, Event
, EventLength
, EventData
, DataLength
, BytesReturned
);
369 return KsSynchronousIoControlDevice(This
->FileObject
, KernelMode
, IOCTL_KS_DISABLE_EVENT
, EventData
, DataLength
, NULL
, 0, BytesReturned
);
374 static IKsControlVtbl vt_IKsControl
=
376 IKsControl_fnQueryInterface
,
378 IKsControl_fnRelease
,
379 IKsControl_fnKsProperty
,
380 IKsControl_fnKsMethod
,
387 IKsFilter_fnQueryInterface(
393 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
395 if (IsEqualGUIDAligned(refiid
, &IID_IUnknown
) ||
396 IsEqualGUIDAligned(refiid
, &IID_IKsFilter
))
398 *Output
= &This
->Header
.OuterUnknown
;
399 _InterlockedIncrement(&This
->ref
);
400 return STATUS_SUCCESS
;
402 else if (IsEqualGUIDAligned(refiid
, &IID_IKsControl
))
404 *Output
= &This
->lpVtblKsControl
;
405 _InterlockedIncrement(&This
->ref
);
406 return STATUS_SUCCESS
;
409 if (This
->Header
.ClientAggregate
)
411 /* using client aggregate */
412 Status
= This
->Header
.ClientAggregate
->lpVtbl
->QueryInterface(This
->Header
.ClientAggregate
, refiid
, Output
);
414 if (NT_SUCCESS(Status
))
416 /* client aggregate supports interface */
421 DPRINT("IKsFilter_fnQueryInterface no interface\n");
422 return STATUS_NOT_SUPPORTED
;
430 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
432 return InterlockedIncrement(&This
->ref
);
440 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
442 InterlockedDecrement(&This
->ref
);
449 /* Return new reference count */
456 IKsFilter_fnGetStruct(
459 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
461 return &This
->Filter
;
466 IKsFilter_fnDoAllNecessaryPinsExist(
475 IKsFilter_fnCreateNode(
479 IN PLIST_ENTRY ListEntry
)
482 return STATUS_NOT_IMPLEMENTED
;
487 IKsFilter_fnBindProcessPinsToPipeSection(
489 IN
struct KSPROCESSPIPESECTION
*Section
,
493 OUT PKSGATE
*OutGate
)
496 return STATUS_NOT_IMPLEMENTED
;
501 IKsFilter_fnUnbindProcessPinsFromPipeSection(
503 IN
struct KSPROCESSPIPESECTION
*Section
)
506 return STATUS_NOT_IMPLEMENTED
;
511 IKsFilter_fnAddProcessPin(
513 IN PKSPROCESSPIN ProcessPin
)
516 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
518 /* first acquire processing mutex */
519 KeWaitForSingleObject(&This
->ProcessingMutex
, Executive
, KernelMode
, FALSE
, NULL
);
522 ASSERT(This
->Filter
.Descriptor
->PinDescriptorsCount
> ProcessPin
->Pin
->Id
);
524 /* allocate new process pin array */
525 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Pins
,
526 (This
->Filter
.Descriptor
->PinDescriptorsCount
+ 1) * sizeof(PVOID
),
527 This
->Filter
.Descriptor
->PinDescriptorsCount
* sizeof(PVOID
),
530 if (NT_SUCCESS(Status
))
532 /* store process pin */
533 This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Pins
[This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
] = ProcessPin
;
534 This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
++;
537 /* release process mutex */
538 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
545 IKsFilter_fnRemoveProcessPin(
547 IN PKSPROCESSPIN ProcessPin
)
551 PKSPROCESSPIN
* Pins
;
553 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
555 /* first acquire processing mutex */
556 KeWaitForSingleObject(&This
->ProcessingMutex
, Executive
, KernelMode
, FALSE
, NULL
);
559 ASSERT(ProcessPin
->Pin
);
560 ASSERT(ProcessPin
->Pin
->Id
);
562 Count
= This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
;
563 Pins
= This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Pins
;
565 /* search for current process pin */
566 for(Index
= 0; Index
< Count
; Index
++)
568 if (Pins
[Index
] == ProcessPin
)
570 RtlMoveMemory(&Pins
[Index
], &Pins
[Index
+ 1], (Count
- (Index
+ 1)) * sizeof(PVOID
));
576 /* decrement pin count */
577 This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
--;
579 if (!This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Count
)
581 /* clear entry object bag will delete it */
582 This
->ProcessPinIndex
[ProcessPin
->Pin
->Id
].Pins
= NULL
;
585 /* release process mutex */
586 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
589 return STATUS_SUCCESS
;
594 IKsFilter_fnReprepareProcessPipeSection(
596 IN
struct KSPROCESSPIPESECTION
*PipeSection
,
605 IKsFilter_fnDeliverResetState(
607 IN
struct KSPROCESSPIPESECTION
*PipeSection
,
608 IN KSRESET ResetState
)
615 IKsFilter_fnIsFrameHolding(
624 IKsFilter_fnRegisterForCopyCallbacks(
632 PKSPROCESSPIN_INDEXENTRY
634 IKsFilter_fnGetProcessDispatch(
637 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(iface
, IKsFilterImpl
, Header
.OuterUnknown
);
639 return This
->ProcessPinIndex
;
642 static IKsFilterVtbl vt_IKsFilter
=
644 IKsFilter_fnQueryInterface
,
647 IKsFilter_fnGetStruct
,
648 IKsFilter_fnDoAllNecessaryPinsExist
,
649 IKsFilter_fnCreateNode
,
650 IKsFilter_fnBindProcessPinsToPipeSection
,
651 IKsFilter_fnUnbindProcessPinsFromPipeSection
,
652 IKsFilter_fnAddProcessPin
,
653 IKsFilter_fnRemoveProcessPin
,
654 IKsFilter_fnReprepareProcessPipeSection
,
655 IKsFilter_fnDeliverResetState
,
656 IKsFilter_fnIsFrameHolding
,
657 IKsFilter_fnRegisterForCopyCallbacks
,
658 IKsFilter_fnGetProcessDispatch
662 IKsFilter_GetFilterFromIrp(
664 OUT IKsFilter
**Filter
)
666 PIO_STACK_LOCATION IoStack
;
667 PKSIOBJECT_HEADER ObjectHeader
;
670 /* get current irp stack */
671 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
674 ASSERT(IoStack
->FileObject
!= NULL
);
676 ObjectHeader
= (PKSIOBJECT_HEADER
)IoStack
->FileObject
->FsContext2
;
678 /* sanity is important */
679 ASSERT(ObjectHeader
!= NULL
);
680 ASSERT(ObjectHeader
->Type
== KsObjectTypeFilter
);
681 ASSERT(ObjectHeader
->Unknown
!= NULL
);
683 /* get our private interface */
684 Status
= ObjectHeader
->Unknown
->lpVtbl
->QueryInterface(ObjectHeader
->Unknown
, &IID_IKsFilter
, (PVOID
*)Filter
);
686 if (!NT_SUCCESS(Status
))
688 /* something is wrong here */
689 DPRINT1("KS: Misbehaving filter %p\n", ObjectHeader
->Unknown
);
690 Irp
->IoStatus
.Status
= Status
;
692 /* complete and forget irp */
693 CompleteRequest(Irp
, IO_NO_INCREMENT
);
702 IKsFilter_DispatchClose(
703 IN PDEVICE_OBJECT DeviceObject
,
707 IKsFilterImpl
* This
;
710 /* obtain filter from object header */
711 Status
= IKsFilter_GetFilterFromIrp(Irp
, &Filter
);
712 if (!NT_SUCCESS(Status
))
715 /* get our real implementation */
716 This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Header
.OuterUnknown
);
718 /* does the driver support notifications */
719 if (This
->Filter
.Descriptor
&& This
->Filter
.Descriptor
->Dispatch
&& This
->Filter
.Descriptor
->Dispatch
->Close
)
721 /* call driver's filter close function */
722 Status
= This
->Filter
.Descriptor
->Dispatch
->Close(&This
->Filter
, Irp
);
725 if (NT_SUCCESS(Status
) && Status
!= STATUS_PENDING
)
727 /* save the result */
728 Irp
->IoStatus
.Status
= Status
;
730 CompleteRequest(Irp
, IO_NO_INCREMENT
);
732 /* remove our instance from the filter factory */
733 IKsFilter_RemoveFilterFromFilterFactory(This
, This
->Factory
);
735 /* free object header */
736 KsFreeObjectHeader(This
->ObjectHeader
);
740 /* complete and forget */
741 Irp
->IoStatus
.Status
= Status
;
743 CompleteRequest(Irp
, IO_NO_INCREMENT
);
751 KspHandlePropertyInstances(
752 IN PIO_STATUS_BLOCK IoStatus
,
753 IN PKSIDENTIFIER Request
,
755 IN IKsFilterImpl
* This
,
758 KSPIN_CINSTANCES
* Instances
;
759 KSP_PIN
* Pin
= (KSP_PIN
*)Request
;
761 if (!This
->Filter
.Descriptor
|| !This
->Filter
.Descriptor
->PinDescriptorsCount
)
763 /* no filter / pin descriptor */
764 IoStatus
->Status
= STATUS_NOT_IMPLEMENTED
;
765 return STATUS_NOT_IMPLEMENTED
;
768 /* ignore custom structs for now */
769 ASSERT(This
->Filter
.Descriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
770 ASSERT(This
->Filter
.Descriptor
->PinDescriptorsCount
> Pin
->PinId
);
772 Instances
= (KSPIN_CINSTANCES
*)Data
;
773 /* max instance count */
774 Instances
->PossibleCount
= This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].InstancesPossible
;
775 /* current instance count */
776 Instances
->CurrentCount
= This
->PinInstanceCount
[Pin
->PinId
];
778 IoStatus
->Information
= sizeof(KSPIN_CINSTANCES
);
779 IoStatus
->Status
= STATUS_SUCCESS
;
780 return STATUS_SUCCESS
;
784 KspHandleNecessaryPropertyInstances(
785 IN PIO_STATUS_BLOCK IoStatus
,
786 IN PKSIDENTIFIER Request
,
788 IN IKsFilterImpl
* This
)
791 KSP_PIN
* Pin
= (KSP_PIN
*)Request
;
793 if (!This
->Filter
.Descriptor
|| !This
->Filter
.Descriptor
->PinDescriptorsCount
)
795 /* no filter / pin descriptor */
796 IoStatus
->Status
= STATUS_NOT_IMPLEMENTED
;
797 return STATUS_NOT_IMPLEMENTED
;
800 /* ignore custom structs for now */
801 ASSERT(This
->Filter
.Descriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
802 ASSERT(This
->Filter
.Descriptor
->PinDescriptorsCount
> Pin
->PinId
);
804 Result
= (PULONG
)Data
;
805 *Result
= This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].InstancesNecessary
;
807 IoStatus
->Information
= sizeof(ULONG
);
808 IoStatus
->Status
= STATUS_SUCCESS
;
809 return STATUS_SUCCESS
;
813 KspHandleDataIntersection(
815 IN PIO_STATUS_BLOCK IoStatus
,
816 IN PKSIDENTIFIER Request
,
819 IN IKsFilterImpl
* This
)
821 PKSMULTIPLE_ITEM MultipleItem
;
822 PKSDATARANGE DataRange
;
823 NTSTATUS Status
= STATUS_NO_MATCH
;
825 PIO_STACK_LOCATION IoStack
;
826 KSP_PIN
* Pin
= (KSP_PIN
*)Request
;
828 /* get stack location */
829 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
832 ASSERT(DataLength
== IoStack
->Parameters
.DeviceIoControl
.OutputBufferLength
);
834 /* Access parameters */
835 MultipleItem
= (PKSMULTIPLE_ITEM
)(Pin
+ 1);
836 DataRange
= (PKSDATARANGE
)(MultipleItem
+ 1);
838 /* FIXME make sure its 64 bit aligned */
839 ASSERT(((ULONG_PTR
)DataRange
& 0x7) == 0);
841 if (!This
->Filter
.Descriptor
|| !This
->Filter
.Descriptor
->PinDescriptorsCount
)
843 /* no filter / pin descriptor */
844 IoStatus
->Status
= STATUS_NOT_IMPLEMENTED
;
845 return STATUS_NOT_IMPLEMENTED
;
848 /* ignore custom structs for now */
849 ASSERT(This
->Filter
.Descriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
850 ASSERT(This
->Filter
.Descriptor
->PinDescriptorsCount
> Pin
->PinId
);
852 if (This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].IntersectHandler
== NULL
||
853 This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].PinDescriptor
.DataRanges
== NULL
||
854 This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].PinDescriptor
.DataRangesCount
== 0)
856 /* no driver supported intersect handler / no provided data ranges */
857 IoStatus
->Status
= STATUS_NOT_IMPLEMENTED
;
858 return STATUS_NOT_IMPLEMENTED
;
861 for(Index
= 0; Index
< MultipleItem
->Count
; Index
++)
863 UNICODE_STRING MajorFormat
, SubFormat
, Specifier
;
864 /* convert the guid to string */
865 RtlStringFromGUID(&DataRange
->MajorFormat
, &MajorFormat
);
866 RtlStringFromGUID(&DataRange
->SubFormat
, &SubFormat
);
867 RtlStringFromGUID(&DataRange
->Specifier
, &Specifier
);
869 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
,
870 DataRange
->FormatSize
, DataRange
->SampleSize
, DataRange
->Alignment
, DataRange
->Flags
, DataRange
->Reserved
, DataLength
);
872 /* FIXME implement KsPinDataIntersectionEx */
873 /* Call miniport's properitary handler */
874 Status
= This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].IntersectHandler(&This
->Filter
,
878 This
->Filter
.Descriptor
->PinDescriptors
[Pin
->PinId
].PinDescriptor
.DataRanges
[0], /* HACK */
882 DPRINT("KspHandleDataIntersection Status %lx\n", Status
);
884 if (Status
== STATUS_SUCCESS
|| Status
== STATUS_BUFFER_OVERFLOW
|| Status
== STATUS_BUFFER_TOO_SMALL
)
887 IoStatus
->Information
= Length
;
891 DataRange
= (PKSDATARANGE
)((PUCHAR
)DataRange
+ DataRange
->FormatSize
);
892 /* FIXME make sure its 64 bit aligned */
893 ASSERT(((ULONG_PTR
)DataRange
& 0x7) == 0);
895 IoStatus
->Status
= Status
;
901 FilterTopologyPropertyHandler(
903 IN PKSIDENTIFIER Request
,
906 IKsFilterImpl
* This
;
908 /* get filter implementation */
909 This
= (IKsFilterImpl
*)KSPROPERTY_ITEM_IRP_STORAGE(Irp
);
914 return KsTopologyPropertyHandler(Irp
, Request
, Data
, &This
->Topology
);
920 FilterGeneralComponentIdHandler(
922 IN PKSIDENTIFIER Request
,
925 PIO_STACK_LOCATION IoStack
;
926 IKsFilterImpl
* This
;
928 /* get filter implementation */
929 This
= (IKsFilterImpl
*)KSPROPERTY_ITEM_IRP_STORAGE(Irp
);
934 /* get current stack location */
935 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
936 ASSERT(IoStack
->Parameters
.DeviceIoControl
.OutputBufferLength
>= sizeof(KSCOMPONENTID
));
938 if (This
->Filter
.Descriptor
->ComponentId
!= NULL
)
940 RtlMoveMemory(Data
, This
->Filter
.Descriptor
->ComponentId
, sizeof(KSCOMPONENTID
));
941 Irp
->IoStatus
.Information
= sizeof(KSCOMPONENTID
);
942 return STATUS_SUCCESS
;
947 return STATUS_NOT_FOUND
;
954 FilterPinPropertyHandler(
956 IN PKSIDENTIFIER Request
,
959 PIO_STACK_LOCATION IoStack
;
960 IKsFilterImpl
* This
;
961 NTSTATUS Status
= STATUS_UNSUCCESSFUL
;
963 /* get filter implementation */
964 This
= (IKsFilterImpl
*)KSPROPERTY_ITEM_IRP_STORAGE(Irp
);
969 /* get current stack location */
970 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
974 case KSPROPERTY_PIN_CTYPES
:
975 case KSPROPERTY_PIN_DATAFLOW
:
976 case KSPROPERTY_PIN_DATARANGES
:
977 case KSPROPERTY_PIN_INTERFACES
:
978 case KSPROPERTY_PIN_MEDIUMS
:
979 case KSPROPERTY_PIN_COMMUNICATION
:
980 case KSPROPERTY_PIN_CATEGORY
:
981 case KSPROPERTY_PIN_NAME
:
982 case KSPROPERTY_PIN_CONSTRAINEDDATARANGES
:
983 Status
= KspPinPropertyHandler(Irp
, Request
, Data
, This
->Filter
.Descriptor
->PinDescriptorsCount
, (const KSPIN_DESCRIPTOR
*)This
->Filter
.Descriptor
->PinDescriptors
, This
->Filter
.Descriptor
->PinDescriptorSize
);
985 case KSPROPERTY_PIN_GLOBALCINSTANCES
:
986 Status
= KspHandlePropertyInstances(&Irp
->IoStatus
, Request
, Data
, This
, TRUE
);
988 case KSPROPERTY_PIN_CINSTANCES
:
989 Status
= KspHandlePropertyInstances(&Irp
->IoStatus
, Request
, Data
, This
, FALSE
);
991 case KSPROPERTY_PIN_NECESSARYINSTANCES
:
992 Status
= KspHandleNecessaryPropertyInstances(&Irp
->IoStatus
, Request
, Data
, This
);
995 case KSPROPERTY_PIN_DATAINTERSECTION
:
996 Status
= KspHandleDataIntersection(Irp
, &Irp
->IoStatus
, Request
, Data
, IoStack
->Parameters
.DeviceIoControl
.OutputBufferLength
, This
);
1000 Status
= STATUS_NOT_FOUND
;
1002 DPRINT("KspPinPropertyHandler Pins %lu Request->Id %lu Status %lx\n", This
->Filter
.Descriptor
->PinDescriptorsCount
, Request
->Id
, Status
);
1010 IKsFilter_DispatchDeviceIoControl(
1011 IN PDEVICE_OBJECT DeviceObject
,
1014 PIO_STACK_LOCATION IoStack
;
1016 IKsFilterImpl
* This
;
1018 PKSFILTER FilterInstance
;
1019 UNICODE_STRING GuidString
;
1020 PKSPROPERTY Property
;
1022 //PKSP_NODE NodeProperty;
1024 /* obtain filter from object header */
1025 Status
= IKsFilter_GetFilterFromIrp(Irp
, &Filter
);
1026 if (!NT_SUCCESS(Status
))
1029 /* get our real implementation */
1030 This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Header
.OuterUnknown
);
1032 /* current irp stack */
1033 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
1035 /* get property from input buffer */
1036 Property
= (PKSPROPERTY
)IoStack
->Parameters
.DeviceIoControl
.Type3InputBuffer
;
1038 /* get filter instance */
1039 FilterInstance
= Filter
->lpVtbl
->GetStruct(Filter
);
1042 ASSERT(IoStack
->Parameters
.DeviceIoControl
.InputBufferLength
>= sizeof(KSIDENTIFIER
));
1043 ASSERT(FilterInstance
);
1044 ASSERT(FilterInstance
->Descriptor
);
1045 ASSERT(FilterInstance
->Descriptor
->AutomationTable
);
1047 /* acquire control mutex */
1048 KeWaitForSingleObject(This
->Header
.ControlMutex
, Executive
, KernelMode
, FALSE
, NULL
);
1050 if (IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_METHOD
)
1052 const KSMETHOD_SET
*MethodSet
= NULL
;
1053 ULONG MethodItemSize
= 0;
1055 /* check if the driver supports method sets */
1056 if (FilterInstance
->Descriptor
->AutomationTable
->MethodSetsCount
)
1058 SetCount
= FilterInstance
->Descriptor
->AutomationTable
->MethodSetsCount
;
1059 MethodSet
= FilterInstance
->Descriptor
->AutomationTable
->MethodSets
;
1060 MethodItemSize
= FilterInstance
->Descriptor
->AutomationTable
->MethodItemSize
;
1063 /* call method set handler */
1064 Status
= KspMethodHandlerWithAllocator(Irp
, SetCount
, MethodSet
, NULL
, MethodItemSize
);
1066 else if (IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_PROPERTY
)
1068 const KSPROPERTY_SET
*PropertySet
= NULL
;
1069 ULONG PropertyItemSize
= 0;
1071 /* check if the driver supports method sets */
1072 if (Property
->Flags
& KSPROPERTY_TYPE_TOPOLOGY
)
1074 NodeProperty
= (PKSP_NODE
)Property
;
1075 if (FilterInstance
->Descriptor
->NodeDescriptors
[NodeProperty
->NodeId
].AutomationTable
!= NULL
)
1077 SetCount
= FilterInstance
->Descriptor
->NodeDescriptors
[NodeProperty
->NodeId
].AutomationTable
->PropertySetsCount
;
1078 PropertySet
= FilterInstance
->Descriptor
->NodeDescriptors
[NodeProperty
->NodeId
].AutomationTable
->PropertySets
;
1079 PropertyItemSize
= 0;
1084 if (FilterInstance
->Descriptor
->AutomationTable
->PropertySetsCount
)
1086 SetCount
= FilterInstance
->Descriptor
->AutomationTable
->PropertySetsCount
;
1087 PropertySet
= FilterInstance
->Descriptor
->AutomationTable
->PropertySets
;
1088 PropertyItemSize
= FilterInstance
->Descriptor
->AutomationTable
->PropertyItemSize
;
1089 // FIXME: handle variable sized property items
1090 ASSERT(PropertyItemSize
== sizeof(KSPROPERTY_ITEM
));
1091 PropertyItemSize
= 0;
1094 /* needed for our property handlers */
1095 KSPROPERTY_ITEM_IRP_STORAGE(Irp
) = (KSPROPERTY_ITEM
*)This
;
1097 /* call property handler */
1098 Status
= KspPropertyHandler(Irp
, SetCount
, PropertySet
, NULL
, PropertyItemSize
);
1103 ASSERT(IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_ENABLE_EVENT
||
1104 IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_DISABLE_EVENT
);
1106 if (IoStack
->Parameters
.DeviceIoControl
.IoControlCode
== IOCTL_KS_ENABLE_EVENT
)
1108 /* call enable event handlers */
1109 Status
= KspEnableEvent(Irp
,
1110 FilterInstance
->Descriptor
->AutomationTable
->EventSetsCount
,
1111 (PKSEVENT_SET
)FilterInstance
->Descriptor
->AutomationTable
->EventSets
,
1112 &This
->Header
.EventList
,
1114 (PVOID
)&This
->Header
.EventListLock
,
1116 FilterInstance
->Descriptor
->AutomationTable
->EventItemSize
);
1120 /* disable event handler */
1121 Status
= KsDisableEvent(Irp
, &This
->Header
.EventList
, KSEVENTS_SPINLOCK
, &This
->Header
.EventListLock
);
1125 RtlStringFromGUID(&Property
->Set
, &GuidString
);
1126 DPRINT("IKsFilter_DispatchDeviceIoControl property PinCount %x\n", FilterInstance
->Descriptor
->PinDescriptorsCount
);
1127 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
);
1128 RtlFreeUnicodeString(&GuidString
);
1130 /* release filter */
1131 Filter
->lpVtbl
->Release(Filter
);
1133 /* release control mutex */
1134 KeReleaseMutex(This
->Header
.ControlMutex
, FALSE
);
1136 if (Status
!= STATUS_PENDING
)
1138 Irp
->IoStatus
.Status
= Status
;
1139 CompleteRequest(Irp
, IO_NO_INCREMENT
);
1146 static KSDISPATCH_TABLE DispatchTable
=
1148 IKsFilter_DispatchDeviceIoControl
,
1149 KsDispatchInvalidDeviceRequest
,
1150 KsDispatchInvalidDeviceRequest
,
1151 KsDispatchInvalidDeviceRequest
,
1152 IKsFilter_DispatchClose
,
1153 KsDispatchQuerySecurity
,
1154 KsDispatchSetSecurity
,
1155 KsDispatchFastIoDeviceControlFailure
,
1156 KsDispatchFastReadFailure
,
1157 KsDispatchFastReadFailure
,
1162 IKsFilter_CreateDescriptors(
1163 IKsFilterImpl
* This
,
1164 KSFILTER_DESCRIPTOR
* FilterDescriptor
)
1168 PKSNODE_DESCRIPTOR NodeDescriptor
;
1170 /* initialize pin descriptors */
1171 This
->FirstPin
= NULL
;
1172 This
->PinInstanceCount
= NULL
;
1173 This
->ProcessPinIndex
= NULL
;
1175 /* initialize topology descriptor */
1176 This
->Topology
.CategoriesCount
= FilterDescriptor
->CategoriesCount
;
1177 This
->Topology
.Categories
= FilterDescriptor
->Categories
;
1178 This
->Topology
.TopologyNodesCount
= FilterDescriptor
->NodeDescriptorsCount
;
1179 This
->Topology
.TopologyConnectionsCount
= FilterDescriptor
->ConnectionsCount
;
1180 This
->Topology
.TopologyConnections
= FilterDescriptor
->Connections
;
1182 /* are there any templates */
1183 if (FilterDescriptor
->PinDescriptorsCount
)
1186 ASSERT(FilterDescriptor
->PinDescriptors
);
1188 /* FIXME handle variable sized pin descriptors */
1189 ASSERT(FilterDescriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
1191 /* store pin descriptors ex */
1192 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->Filter
.Descriptor
->PinDescriptors
, FilterDescriptor
->PinDescriptorSize
* FilterDescriptor
->PinDescriptorsCount
,
1193 FilterDescriptor
->PinDescriptorSize
* FilterDescriptor
->PinDescriptorsCount
, 0);
1195 if (!NT_SUCCESS(Status
))
1197 DPRINT("IKsFilter_CreateDescriptors _KsEdit failed %lx\n", Status
);
1201 /* store pin instance count */
1202 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->PinInstanceCount
, sizeof(ULONG
) * FilterDescriptor
->PinDescriptorsCount
,
1203 sizeof(ULONG
) * FilterDescriptor
->PinDescriptorsCount
, 0);
1205 if (!NT_SUCCESS(Status
))
1207 DPRINT("IKsFilter_CreateDescriptors _KsEdit failed %lx\n", Status
);
1211 /* store instantiated pin arrays */
1212 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->FirstPin
, sizeof(PVOID
) * FilterDescriptor
->PinDescriptorsCount
,
1213 sizeof(PVOID
) * FilterDescriptor
->PinDescriptorsCount
, 0);
1215 if (!NT_SUCCESS(Status
))
1217 DPRINT("IKsFilter_CreateDescriptors _KsEdit failed %lx\n", Status
);
1221 /* add new pin factory */
1222 RtlMoveMemory((PVOID
)This
->Filter
.Descriptor
->PinDescriptors
, FilterDescriptor
->PinDescriptors
, FilterDescriptor
->PinDescriptorSize
* FilterDescriptor
->PinDescriptorsCount
);
1224 /* allocate process pin index */
1225 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->ProcessPinIndex
, sizeof(KSPROCESSPIN_INDEXENTRY
) * FilterDescriptor
->PinDescriptorsCount
,
1226 sizeof(KSPROCESSPIN_INDEXENTRY
) * FilterDescriptor
->PinDescriptorsCount
, 0);
1228 if (!NT_SUCCESS(Status
))
1230 DPRINT("IKsFilter_CreateDescriptors _KsEdit failed %lx\n", Status
);
1237 if (FilterDescriptor
->ConnectionsCount
)
1239 /* modify connections array */
1240 Status
= _KsEdit(This
->Filter
.Bag
,
1241 (PVOID
*)&This
->Filter
.Descriptor
->Connections
,
1242 FilterDescriptor
->ConnectionsCount
* sizeof(KSTOPOLOGY_CONNECTION
),
1243 FilterDescriptor
->ConnectionsCount
* sizeof(KSTOPOLOGY_CONNECTION
),
1246 This
->Topology
.TopologyConnections
= This
->Filter
.Descriptor
->Connections
;
1247 This
->Topology
.TopologyConnectionsCount
= ((PKSFILTER_DESCRIPTOR
)This
->Filter
.Descriptor
)->ConnectionsCount
= FilterDescriptor
->ConnectionsCount
;
1250 if (FilterDescriptor
->NodeDescriptorsCount
)
1253 ASSERT(FilterDescriptor
->NodeDescriptors
);
1256 ASSERT(FilterDescriptor
->NodeDescriptorSize
>= sizeof(KSNODE_DESCRIPTOR
));
1258 This
->Topology
.TopologyNodes
= AllocateItem(NonPagedPool
, sizeof(GUID
) * FilterDescriptor
->NodeDescriptorsCount
);
1259 /* allocate topology node types array */
1260 if (!This
->Topology
.TopologyNodes
)
1262 DPRINT("IKsFilter_CreateDescriptors OutOfMemory TopologyNodesCount %lu\n", FilterDescriptor
->NodeDescriptorsCount
);
1263 return STATUS_INSUFFICIENT_RESOURCES
;
1266 This
->Topology
.TopologyNodesNames
= AllocateItem(NonPagedPool
, sizeof(GUID
) * FilterDescriptor
->NodeDescriptorsCount
);
1267 /* allocate topology names array */
1268 if (!This
->Topology
.TopologyNodesNames
)
1270 FreeItem((PVOID
)This
->Topology
.TopologyNodes
);
1271 DPRINT("IKsFilter_CreateDescriptors OutOfMemory TopologyNodesCount %lu\n", FilterDescriptor
->NodeDescriptorsCount
);
1272 return STATUS_INSUFFICIENT_RESOURCES
;
1275 DPRINT("NodeDescriptorCount %lu\n", FilterDescriptor
->NodeDescriptorsCount
);
1276 NodeDescriptor
= (PKSNODE_DESCRIPTOR
)FilterDescriptor
->NodeDescriptors
;
1277 for(Index
= 0; Index
< FilterDescriptor
->NodeDescriptorsCount
; Index
++)
1279 DPRINT("Index %lu Type %p Name %p\n", Index
, NodeDescriptor
->Type
, NodeDescriptor
->Name
);
1281 /* copy topology type */
1282 if (NodeDescriptor
->Type
)
1283 RtlMoveMemory((PVOID
)&This
->Topology
.TopologyNodes
[Index
], NodeDescriptor
->Type
, sizeof(GUID
));
1285 /* copy topology name */
1286 if (NodeDescriptor
->Name
)
1287 RtlMoveMemory((PVOID
)&This
->Topology
.TopologyNodesNames
[Index
], NodeDescriptor
->Name
, sizeof(GUID
));
1289 // next node descriptor
1290 NodeDescriptor
= (PKSNODE_DESCRIPTOR
)((ULONG_PTR
)NodeDescriptor
+ FilterDescriptor
->NodeDescriptorSize
);
1294 return STATUS_SUCCESS
;
1298 IKsFilter_CopyFilterDescriptor(
1299 IKsFilterImpl
* This
,
1300 const KSFILTER_DESCRIPTOR
* FilterDescriptor
)
1303 KSAUTOMATION_TABLE AutomationTable
;
1305 This
->Filter
.Descriptor
= AllocateItem(NonPagedPool
, sizeof(KSFILTER_DESCRIPTOR
));
1306 if (!This
->Filter
.Descriptor
)
1307 return STATUS_INSUFFICIENT_RESOURCES
;
1309 Status
= KsAddItemToObjectBag(This
->Filter
.Bag
, (PVOID
)This
->Filter
.Descriptor
, NULL
);
1310 if (!NT_SUCCESS(Status
))
1312 FreeItem((PVOID
)This
->Filter
.Descriptor
);
1313 This
->Filter
.Descriptor
= NULL
;
1314 return STATUS_INSUFFICIENT_RESOURCES
;
1317 /* copy filter descriptor fields */
1318 RtlMoveMemory((PVOID
)This
->Filter
.Descriptor
, FilterDescriptor
, sizeof(KSFILTER_DESCRIPTOR
));
1320 /* zero automation table */
1321 RtlZeroMemory(&AutomationTable
, sizeof(KSAUTOMATION_TABLE
));
1323 /* setup filter property sets */
1324 AutomationTable
.PropertyItemSize
= sizeof(KSPROPERTY_ITEM
);
1325 AutomationTable
.PropertySetsCount
= 3;
1326 AutomationTable
.PropertySets
= FilterPropertySet
;
1328 /* merge filter automation table */
1329 Status
= KsMergeAutomationTables((PKSAUTOMATION_TABLE
*)&This
->Filter
.Descriptor
->AutomationTable
, (PKSAUTOMATION_TABLE
)FilterDescriptor
->AutomationTable
, &AutomationTable
, This
->Filter
.Bag
);
1340 PKSPIN NextPin
, CurPin
;
1341 PKSBASIC_HEADER BasicHeader
;
1342 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1345 ASSERT(Pin
->Id
< This
->Filter
.Descriptor
->PinDescriptorsCount
);
1347 if (This
->FirstPin
[Pin
->Id
] == NULL
)
1349 /* welcome first pin */
1350 This
->FirstPin
[Pin
->Id
] = Pin
;
1351 This
->PinInstanceCount
[Pin
->Id
]++;
1356 CurPin
= This
->FirstPin
[Pin
->Id
];
1360 /* get next instantiated pin */
1361 NextPin
= KsPinGetNextSiblingPin(CurPin
);
1367 }while(NextPin
!= NULL
);
1369 /* get basic header */
1370 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)CurPin
- sizeof(KSBASIC_HEADER
));
1373 BasicHeader
->Next
.Pin
= Pin
;
1377 IKsFilter_RemovePin(
1381 PKSPIN NextPin
, CurPin
, LastPin
;
1382 PKSBASIC_HEADER BasicHeader
;
1383 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1386 ASSERT(Pin
->Id
< This
->Filter
.Descriptor
->PinDescriptorsCount
);
1389 CurPin
= This
->FirstPin
[Pin
->Id
];
1394 /* get next instantiated pin */
1395 NextPin
= KsPinGetNextSiblingPin(CurPin
);
1401 /* get basic header of last pin */
1402 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)LastPin
- sizeof(KSBASIC_HEADER
));
1404 BasicHeader
->Next
.Pin
= NextPin
;
1408 /* erase last pin */
1409 This
->FirstPin
[Pin
->Id
] = NextPin
;
1411 /* decrement pin instance count */
1412 This
->PinInstanceCount
[Pin
->Id
]--;
1422 }while(NextPin
!= NULL
);
1431 IKsFilter_DispatchCreatePin(
1432 IN PDEVICE_OBJECT DeviceObject
,
1435 IKsFilterImpl
* This
;
1436 PKSOBJECT_CREATE_ITEM CreateItem
;
1437 PKSPIN_CONNECT Connect
;
1440 DPRINT("IKsFilter_DispatchCreatePin\n");
1442 /* get the create item */
1443 CreateItem
= KSCREATE_ITEM_IRP_STORAGE(Irp
);
1445 /* get the filter object */
1446 This
= (IKsFilterImpl
*)CreateItem
->Context
;
1449 ASSERT(This
->Header
.Type
== KsObjectTypeFilter
);
1451 /* acquire control mutex */
1452 KeWaitForSingleObject(This
->Header
.ControlMutex
, Executive
, KernelMode
, FALSE
, NULL
);
1454 /* now validate the connect request */
1455 Status
= KspValidateConnectRequest(Irp
, This
->Filter
.Descriptor
->PinDescriptorsCount
, (PVOID
)This
->Filter
.Descriptor
->PinDescriptors
, This
->Filter
.Descriptor
->PinDescriptorSize
, &Connect
);
1457 DPRINT("IKsFilter_DispatchCreatePin KsValidateConnectRequest %lx\n", Status
);
1459 if (NT_SUCCESS(Status
))
1462 ASSERT(Connect
->PinId
< This
->Filter
.Descriptor
->PinDescriptorsCount
);
1464 DPRINT("IKsFilter_DispatchCreatePin KsValidateConnectRequest PinId %lu CurrentInstanceCount %lu MaxPossible %lu\n", Connect
->PinId
,
1465 This
->PinInstanceCount
[Connect
->PinId
],
1466 This
->Filter
.Descriptor
->PinDescriptors
[Connect
->PinId
].InstancesPossible
);
1468 if (This
->PinInstanceCount
[Connect
->PinId
] < This
->Filter
.Descriptor
->PinDescriptors
[Connect
->PinId
].InstancesPossible
)
1470 /* create the pin */
1471 Status
= KspCreatePin(DeviceObject
, Irp
, This
->Header
.KsDevice
, This
->FilterFactory
, (IKsFilter
*)&This
->Header
.OuterUnknown
, Connect
, (KSPIN_DESCRIPTOR_EX
*)&This
->Filter
.Descriptor
->PinDescriptors
[Connect
->PinId
]);
1473 DPRINT("IKsFilter_DispatchCreatePin KspCreatePin %lx\n", Status
);
1477 /* maximum instance count reached, bye-bye */
1478 Status
= STATUS_UNSUCCESSFUL
;
1479 DPRINT("IKsFilter_DispatchCreatePin MaxInstance %lu CurInstance %lu %lx\n", This
->Filter
.Descriptor
->PinDescriptors
[Connect
->PinId
].InstancesPossible
, This
->PinInstanceCount
[Connect
->PinId
]);
1483 /* release control mutex */
1484 KeReleaseMutex(This
->Header
.ControlMutex
, FALSE
);
1486 if (Status
!= STATUS_PENDING
)
1488 /* complete request */
1489 Irp
->IoStatus
.Status
= Status
;
1490 CompleteRequest(Irp
, IO_NO_INCREMENT
);
1494 DPRINT("IKsFilter_DispatchCreatePin Result %lx\n", Status
);
1500 IKsFilter_DispatchCreateNode(
1501 IN PDEVICE_OBJECT DeviceObject
,
1505 Irp
->IoStatus
.Status
= STATUS_UNSUCCESSFUL
;
1506 CompleteRequest(Irp
, IO_NO_INCREMENT
);
1507 return STATUS_UNSUCCESSFUL
;
1512 IKsFilter_AttachFilterToFilterFactory(
1513 IKsFilterImpl
* This
,
1514 PKSFILTERFACTORY FilterFactory
)
1516 PKSBASIC_HEADER BasicHeader
;
1520 /* get filter factory basic header */
1521 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)FilterFactory
- sizeof(KSBASIC_HEADER
));
1524 ASSERT(BasicHeader
->Type
== KsObjectTypeFilterFactory
);
1526 if (BasicHeader
->FirstChild
.FilterFactory
== NULL
)
1528 /* welcome first instantiated filter */
1529 BasicHeader
->FirstChild
.Filter
= &This
->Filter
;
1533 /* set to first entry */
1534 Filter
= BasicHeader
->FirstChild
.Filter
;
1538 /* get basic header */
1539 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)Filter
- sizeof(KSBASIC_HEADER
));
1541 ASSERT(BasicHeader
->Type
== KsObjectTypeFilter
);
1543 if (BasicHeader
->Next
.Filter
)
1545 /* iterate to next filter factory */
1546 Filter
= BasicHeader
->Next
.Filter
;
1550 /* found last entry */
1555 /* attach filter factory */
1556 BasicHeader
->Next
.Filter
= &This
->Filter
;
1560 IKsFilter_RemoveFilterFromFilterFactory(
1561 IKsFilterImpl
* This
,
1562 PKSFILTERFACTORY FilterFactory
)
1564 PKSBASIC_HEADER BasicHeader
;
1565 PKSFILTER Filter
, LastFilter
;
1567 /* get filter factory basic header */
1568 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)FilterFactory
- sizeof(KSBASIC_HEADER
));
1571 ASSERT(BasicHeader
->Type
== KsObjectTypeFilterFactory
);
1572 ASSERT(BasicHeader
->FirstChild
.Filter
!= NULL
);
1575 /* set to first entry */
1576 Filter
= BasicHeader
->FirstChild
.Filter
;
1581 if (Filter
== &This
->Filter
)
1585 /* get basic header */
1586 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)LastFilter
- sizeof(KSBASIC_HEADER
));
1587 /* remove filter instance */
1588 BasicHeader
->Next
.Filter
= This
->Header
.Next
.Filter
;
1593 /* remove filter instance */
1594 BasicHeader
->FirstChild
.Filter
= This
->Header
.Next
.Filter
;
1599 /* get basic header */
1600 BasicHeader
= (PKSBASIC_HEADER
)((ULONG_PTR
)Filter
- sizeof(KSBASIC_HEADER
));
1602 ASSERT(BasicHeader
->Type
== KsObjectTypeFilter
);
1604 LastFilter
= Filter
;
1605 if (BasicHeader
->Next
.Filter
)
1607 /* iterate to next filter factory */
1608 Filter
= BasicHeader
->Next
.Filter
;
1612 /* filter is not in list */
1621 IKsFilter_FilterCentricWorker(
1624 IKsProcessingObject
* Object
= (IKsProcessingObject
*)Ctx
;
1630 Object
->lpVtbl
->ProcessingObjectWork(Object
);
1636 IN PDEVICE_OBJECT DeviceObject
,
1638 IN IKsFilterFactory
*iface
)
1640 IKsFilterImpl
* This
;
1641 IKsDevice
*KsDevice
;
1642 PKSFILTERFACTORY Factory
;
1643 PIO_STACK_LOCATION IoStack
;
1644 PDEVICE_EXTENSION DeviceExtension
;
1646 PKSOBJECT_CREATE_ITEM CreateItem
;
1648 /* get device extension */
1649 DeviceExtension
= (PDEVICE_EXTENSION
)DeviceObject
->DeviceExtension
;
1651 /* get the filter factory */
1652 Factory
= iface
->lpVtbl
->GetStruct(iface
);
1654 if (!Factory
|| !Factory
->FilterDescriptor
)
1656 /* Sorry it just will not work */
1657 return STATUS_UNSUCCESSFUL
;
1660 if (Factory
->FilterDescriptor
->Flags
& KSFILTER_FLAG_DENY_USERMODE_ACCESS
)
1662 if (Irp
->RequestorMode
== UserMode
)
1664 /* filter not accessible from user mode */
1665 DPRINT1("Access denied\n");
1666 return STATUS_UNSUCCESSFUL
;
1670 /* allocate filter instance */
1671 This
= AllocateItem(NonPagedPool
, sizeof(IKsFilterImpl
));
1674 DPRINT1("KspCreateFilter OutOfMemory\n");
1675 return STATUS_INSUFFICIENT_RESOURCES
;
1678 /* initialize object bag */
1679 This
->Filter
.Bag
= AllocateItem(NonPagedPool
, sizeof(KSIOBJECT_BAG
));
1680 if (!This
->Filter
.Bag
)
1684 DPRINT1("KspCreateFilter OutOfMemory\n");
1685 return STATUS_INSUFFICIENT_RESOURCES
;
1687 KsDevice
= (IKsDevice
*)&DeviceExtension
->DeviceHeader
->BasicHeader
.OuterUnknown
;
1688 KsDevice
->lpVtbl
->InitializeObjectBag(KsDevice
, (PKSIOBJECT_BAG
)This
->Filter
.Bag
, NULL
);
1690 /* copy filter descriptor */
1691 Status
= IKsFilter_CopyFilterDescriptor(This
, Factory
->FilterDescriptor
);
1692 if (!NT_SUCCESS(Status
))
1694 /* not enough memory */
1695 FreeItem(This
->Filter
.Bag
);
1697 DPRINT("KspCreateFilter IKsFilter_CopyFilterDescriptor failed %lx\n", Status
);
1698 return STATUS_INSUFFICIENT_RESOURCES
;
1701 /* get current irp stack */
1702 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
1704 /* allocate create items */
1705 CreateItem
= AllocateItem(NonPagedPool
, sizeof(KSOBJECT_CREATE_ITEM
) * 2);
1709 FreeItem(This
->Filter
.Bag
);
1711 DPRINT1("KspCreateFilter OutOfMemory\n");
1712 return STATUS_INSUFFICIENT_RESOURCES
;
1715 /* initialize pin create item */
1716 CreateItem
[0].Create
= IKsFilter_DispatchCreatePin
;
1717 CreateItem
[0].Context
= (PVOID
)This
;
1718 CreateItem
[0].Flags
= KSCREATE_ITEM_FREEONSTOP
;
1719 RtlInitUnicodeString(&CreateItem
[0].ObjectClass
, KSSTRING_Pin
);
1720 /* initialize node create item */
1721 CreateItem
[1].Create
= IKsFilter_DispatchCreateNode
;
1722 CreateItem
[1].Context
= (PVOID
)This
;
1723 CreateItem
[1].Flags
= KSCREATE_ITEM_FREEONSTOP
;
1724 RtlInitUnicodeString(&CreateItem
[1].ObjectClass
, KSSTRING_TopologyNode
);
1727 /* initialize filter instance */
1729 This
->Header
.OuterUnknown
= (PUNKNOWN
)&vt_IKsFilter
;
1730 This
->lpVtblKsControl
= &vt_IKsControl
;
1731 This
->lpVtblKsProcessingObject
= &vt_IKsProcessingObject
;
1733 This
->Factory
= Factory
;
1734 This
->FilterFactory
= iface
;
1735 This
->FileObject
= IoStack
->FileObject
;
1736 KeInitializeMutex(&This
->ProcessingMutex
, 0);
1738 /* initialize basic header */
1739 This
->Header
.KsDevice
= &DeviceExtension
->DeviceHeader
->KsDevice
;
1740 This
->Header
.Parent
.KsFilterFactory
= iface
->lpVtbl
->GetStruct(iface
);
1741 This
->Header
.Type
= KsObjectTypeFilter
;
1742 This
->Header
.ControlMutex
= &This
->ControlMutex
;
1743 KeInitializeMutex(This
->Header
.ControlMutex
, 0);
1744 InitializeListHead(&This
->Header
.EventList
);
1745 KeInitializeSpinLock(&This
->Header
.EventListLock
);
1747 /* initialize and gate */
1748 KsGateInitializeAnd(&This
->Gate
, NULL
);
1750 /* FIXME initialize and gate based on pin flags */
1752 /* initialize work item */
1753 ExInitializeWorkItem(&This
->WorkItem
, IKsFilter_FilterCentricWorker
, (PVOID
)This
->lpVtblKsProcessingObject
);
1755 /* allocate counted work item */
1756 Status
= KsRegisterCountedWorker(HyperCriticalWorkQueue
, &This
->WorkItem
, &This
->Worker
);
1757 if (!NT_SUCCESS(Status
))
1759 /* what can go wrong, goes wrong */
1760 DPRINT1("KsRegisterCountedWorker failed with %lx\n", Status
);
1762 FreeItem(CreateItem
);
1766 /* allocate the stream descriptors */
1767 Status
= IKsFilter_CreateDescriptors(This
, (PKSFILTER_DESCRIPTOR
)Factory
->FilterDescriptor
);
1768 if (!NT_SUCCESS(Status
))
1770 /* what can go wrong, goes wrong */
1771 DPRINT1("IKsFilter_CreateDescriptors failed with %lx\n", Status
);
1772 KsUnregisterWorker(This
->Worker
);
1774 FreeItem(CreateItem
);
1780 /* does the filter have a filter dispatch */
1781 if (Factory
->FilterDescriptor
->Dispatch
)
1783 /* does it have a create routine */
1784 if (Factory
->FilterDescriptor
->Dispatch
->Create
)
1786 /* now let driver initialize the filter instance */
1788 ASSERT(This
->Header
.KsDevice
);
1789 ASSERT(This
->Header
.KsDevice
->Started
);
1790 Status
= Factory
->FilterDescriptor
->Dispatch
->Create(&This
->Filter
, Irp
);
1792 if (!NT_SUCCESS(Status
) && Status
!= STATUS_PENDING
)
1794 /* driver failed to initialize */
1795 DPRINT1("Driver: Status %x\n", Status
);
1797 /* free filter instance */
1798 KsUnregisterWorker(This
->Worker
);
1800 FreeItem(CreateItem
);
1806 /* now allocate the object header */
1807 Status
= KsAllocateObjectHeader((PVOID
*)&This
->ObjectHeader
, 2, CreateItem
, Irp
, &DispatchTable
);
1808 if (!NT_SUCCESS(Status
))
1810 /* failed to allocate object header */
1811 DPRINT1("Failed to allocate object header %x\n", Status
);
1816 /* initialize object header extra fields */
1817 This
->ObjectHeader
->Type
= KsObjectTypeFilter
;
1818 This
->ObjectHeader
->Unknown
= (PUNKNOWN
)&This
->Header
.OuterUnknown
;
1819 This
->ObjectHeader
->ObjectType
= (PVOID
)&This
->Filter
;
1821 /* attach filter to filter factory */
1822 IKsFilter_AttachFilterToFilterFactory(This
, This
->Header
.Parent
.KsFilterFactory
);
1824 /* completed initialization */
1825 DPRINT1("KspCreateFilter done %lx KsDevice %p\n", Status
, This
->Header
.KsDevice
);
1835 KsFilterAcquireProcessingMutex(
1836 IN PKSFILTER Filter
)
1838 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1840 KeWaitForSingleObject(&This
->ProcessingMutex
, Executive
, KernelMode
, FALSE
, NULL
);
1849 KsFilterReleaseProcessingMutex(
1850 IN PKSFILTER Filter
)
1852 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1854 KeReleaseMutex(&This
->ProcessingMutex
, FALSE
);
1864 KsFilterAddTopologyConnections (
1865 IN PKSFILTER Filter
,
1866 IN ULONG NewConnectionsCount
,
1867 IN
const KSTOPOLOGY_CONNECTION
*const NewTopologyConnections
)
1871 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1873 DPRINT("KsFilterAddTopologyConnections\n");
1875 ASSERT(This
->Filter
.Descriptor
);
1876 Count
= This
->Filter
.Descriptor
->ConnectionsCount
+ NewConnectionsCount
;
1879 /* modify connections array */
1880 Status
= _KsEdit(This
->Filter
.Bag
,
1881 (PVOID
*)&This
->Filter
.Descriptor
->Connections
,
1882 Count
* sizeof(KSTOPOLOGY_CONNECTION
),
1883 This
->Filter
.Descriptor
->ConnectionsCount
* sizeof(KSTOPOLOGY_CONNECTION
),
1886 if (!NT_SUCCESS(Status
))
1889 DPRINT("KsFilterAddTopologyConnections KsEdit failed with %lx\n", Status
);
1893 /* FIXME verify connections */
1895 /* copy new connections */
1896 RtlMoveMemory((PVOID
)&This
->Filter
.Descriptor
->Connections
[This
->Filter
.Descriptor
->ConnectionsCount
],
1897 NewTopologyConnections
,
1898 NewConnectionsCount
* sizeof(KSTOPOLOGY_CONNECTION
));
1900 /* update topology */
1901 This
->Topology
.TopologyConnectionsCount
+= NewConnectionsCount
;
1902 ((PKSFILTER_DESCRIPTOR
)This
->Filter
.Descriptor
)->ConnectionsCount
+= NewConnectionsCount
;
1903 This
->Topology
.TopologyConnections
= This
->Filter
.Descriptor
->Connections
;
1914 KsFilterAttemptProcessing(
1915 IN PKSFILTER Filter
,
1916 IN BOOLEAN Asynchronous
)
1919 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1922 Gate
= This
->lpVtblKsProcessingObject
->GetAndGate((IKsProcessingObject
*)This
->lpVtblKsProcessingObject
);
1924 if (!KsGateCaptureThreshold(Gate
))
1926 /* filter control gate is closed */
1929 DPRINT1("processing\n");
1930 /* try initiate processing */
1931 This
->lpVtblKsProcessingObject
->Process((IKsProcessingObject
*)This
->lpVtblKsProcessingObject
, Asynchronous
);
1940 KsFilterCreateNode (
1941 IN PKSFILTER Filter
,
1942 IN
const KSNODE_DESCRIPTOR
*const NodeDescriptor
,
1946 return STATUS_NOT_IMPLEMENTED
;
1955 KsFilterCreatePinFactory (
1956 IN PKSFILTER Filter
,
1957 IN
const KSPIN_DESCRIPTOR_EX
*const InPinDescriptor
,
1962 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
1964 DPRINT("KsFilterCreatePinFactory\n");
1966 /* calculate new count */
1967 Count
= This
->Filter
.Descriptor
->PinDescriptorsCount
+ 1;
1970 ASSERT(This
->Filter
.Descriptor
->PinDescriptorSize
== sizeof(KSPIN_DESCRIPTOR_EX
));
1972 /* modify pin descriptors ex array */
1973 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->Filter
.Descriptor
->PinDescriptors
, Count
* This
->Filter
.Descriptor
->PinDescriptorSize
, This
->Filter
.Descriptor
->PinDescriptorsCount
* This
->Filter
.Descriptor
->PinDescriptorSize
, 0);
1974 if (!NT_SUCCESS(Status
))
1977 DPRINT("KsFilterCreatePinFactory _KsEdit failed with %lx\n", Status
);
1981 /* modify pin instance count array */
1982 Status
= _KsEdit(This
->Filter
.Bag
,(PVOID
*)&This
->PinInstanceCount
, sizeof(ULONG
) * Count
, sizeof(ULONG
) * This
->Filter
.Descriptor
->PinDescriptorsCount
, 0);
1983 if (!NT_SUCCESS(Status
))
1986 DPRINT("KsFilterCreatePinFactory _KsEdit failed with %lx\n", Status
);
1990 /* modify first pin array */
1991 Status
= _KsEdit(This
->Filter
.Bag
,(PVOID
*)&This
->FirstPin
, sizeof(PVOID
) * Count
, sizeof(PVOID
) * This
->Filter
.Descriptor
->PinDescriptorsCount
, 0);
1992 if (!NT_SUCCESS(Status
))
1995 DPRINT("KsFilterCreatePinFactory _KsEdit failed with %lx\n", Status
);
1999 /* add new pin factory */
2000 RtlMoveMemory((PVOID
)&This
->Filter
.Descriptor
->PinDescriptors
[This
->Filter
.Descriptor
->PinDescriptorsCount
], InPinDescriptor
, sizeof(KSPIN_DESCRIPTOR_EX
));
2002 /* allocate process pin index */
2003 Status
= _KsEdit(This
->Filter
.Bag
, (PVOID
*)&This
->ProcessPinIndex
, sizeof(KSPROCESSPIN_INDEXENTRY
) * Count
,
2004 sizeof(KSPROCESSPIN_INDEXENTRY
) * This
->Filter
.Descriptor
->PinDescriptorsCount
, 0);
2006 if (!NT_SUCCESS(Status
))
2008 DPRINT("KsFilterCreatePinFactory _KsEdit failed %lx\n", Status
);
2012 /* store new pin id */
2013 *PinID
= This
->Filter
.Descriptor
->PinDescriptorsCount
;
2015 /* increment pin descriptor count */
2016 ((PKSFILTER_DESCRIPTOR
)This
->Filter
.Descriptor
)->PinDescriptorsCount
++;
2019 DPRINT("KsFilterCreatePinFactory done\n");
2020 return STATUS_SUCCESS
;
2031 IN PKSFILTER Filter
)
2033 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
2035 /* return and-gate */
2045 KsFilterGetChildPinCount(
2046 IN PKSFILTER Filter
,
2049 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
2051 if (PinId
>= This
->Filter
.Descriptor
->PinDescriptorsCount
)
2053 /* index is out of bounds */
2056 /* return pin instance count */
2057 return This
->PinInstanceCount
[PinId
];
2066 KsFilterGetFirstChildPin(
2067 IN PKSFILTER Filter
,
2070 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
2072 if (PinId
>= This
->Filter
.Descriptor
->PinDescriptorsCount
)
2074 /* index is out of bounds */
2078 /* return first pin index */
2079 return This
->FirstPin
[PinId
];
2088 KsFilterRegisterPowerCallbacks(
2089 IN PKSFILTER Filter
,
2090 IN PFNKSFILTERPOWER Sleep OPTIONAL
,
2091 IN PFNKSFILTERPOWER Wake OPTIONAL
)
2093 IKsFilterImpl
* This
= (IKsFilterImpl
*)CONTAINING_RECORD(Filter
, IKsFilterImpl
, Filter
);
2095 This
->Sleep
= Sleep
;
2108 PIO_STACK_LOCATION IoStack
;
2109 PKSIOBJECT_HEADER ObjectHeader
;
2111 DPRINT("KsGetFilterFromIrp\n");
2113 /* get current irp stack location */
2114 IoStack
= IoGetCurrentIrpStackLocation(Irp
);
2117 ASSERT(IoStack
->FileObject
);
2119 /* get object header */
2120 ObjectHeader
= (PKSIOBJECT_HEADER
)IoStack
->FileObject
->FsContext2
;
2122 if (ObjectHeader
->Type
== KsObjectTypeFilter
)
2124 /* irp is targeted at the filter */
2125 return (PKSFILTER
)ObjectHeader
->ObjectType
;
2127 else if (ObjectHeader
->Type
== KsObjectTypePin
)
2129 /* irp is for a pin */
2130 return KsPinGetParentFilter((PKSPIN
)ObjectHeader
->ObjectType
);
2134 /* irp is unappropiate to retrieve a filter */