KsDefaultDispatchPnp function

The KsDefaultDispatchPnp function is the default, main PnP dispatch handler; notifications regarding the functional device object can be directed to this handler. This function passes all notifications to the PnP device object previously set with KsSetDevicePnpAndBaseObject and assumes the use of a device header. When the function is passed an IRP_MN_REMOVE_DEVICE, the device object is deleted.

Syntax

KSDDKAPI NTSTATUS NTAPI KsDefaultDispatchPnp(
  _In_ PDEVICE_OBJECT DeviceObject,
  _In_ PIRP           Irp
);

Parameters

• DeviceObject [in]
  Specifies the functional device object.

• Irp [in]
  Specifies the PnP IRP.

Return value

The KsDefaultDispatchPnp function returns the status of the underlying physical device object IRP processing.

Remarks

The KsDefaultDispatchPnp function is useful when there is no extra cleanup needed when removing a device beyond freeing the device header and deleting the actual device object.

Requirements

Send comments about this topic to Microsoft