Edit

KsServiceBusEnumCreateRequest function (swenum.h)

  • Article

This function is intended for internal use only.

The KsServiceBusEnumCreateRequest function services IRP_MJ_CREATE requests for the software bus device interface.

Syntax

KSDDKAPI NTSTATUS KsServiceBusEnumCreateRequest(
  [in]      PDEVICE_OBJECT DeviceObject,
  [in, out] PIRP           Irp
);

Parameters

[in] DeviceObject

Pointer to the device object.

[in, out] Irp

Pointer to the IRP that is associated with the device object.

Return value

Returns STATUS_SUCCESS if successful. Otherwise. it returns STATUS_OBJECT_NAME_NOT_FOUND if the IRP's FileObject->FileName is NULL or if the reference string cannot be located. Otherwise, an appropriate error returns.

Remarks

KsServiceBusEnumCreateRequest services the IRP_MJ_CREATE request for the registered device interface by matching the given IRP's FileObject->FileName with the registered bus reference strings. If the device reference is present, enumerated and created, the IRP is simply re-routed to the actual device. If the reference string is NULL, it is assumed that this is a request for the bus interface and the IRP_MJ_CREATE is completed. If the device reference has not already been enumerated, or is not active, the IRP is queued and a PDO is created and a bus enumeration is initiated by IoInvalidateDeviceRelations().

Requirements

Requirement Value
Target Platform Universal
Header swenum.h (include Swenum.h)
Library Ks.lib

See also

KsServiceBusEnumPnpRequest