KsDispatchInvalidDeviceRequest function (ks.h)

Article
02/22/2024

The KsDispatchInvalidDeviceRequest function is used in KSDISPATCH_TABLE entries that are not handled and that need to return STATUS_INVALID_DEVICE_REQUEST.

Syntax

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

Parameters

[in] DeviceObject

Specifies the device object associated with the IRP.

[in] Irp

Specifies the IRP that is not being handled.

Return value

The KsDispatchInvalidDeviceRequest function returns STATUS_INVALID_DEVICE_REQUEST and completes the IRP.

Remarks

The KsDispatchInvalidDeviceRequest function is needed because the dispatch table for an opened instance of a device may not handle a specific major function that another opened instance needs to handle. Therefore, the function pointer in the driver object must always point to a function that calls a dispatch table entry.

Requirements

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