PFNKSDEVICE callback function (ks.h)

  • Article

An AVStream minidriver's AVStrMiniDevicePostStart routine is called when AVStream performs post-PnP-start processing. Use it to load drivers at start time, for example. Such events then will occur in the context of a worker thread after PnP start.

Syntax

PFNKSDEVICE Pfnksdevice;

NTSTATUS Pfnksdevice(
  [in] PKSDEVICE Device
)
{...}

Parameters

[in] Device

Pointer to a KSDEVICE structure describing the device for which the IRP_MN_START_DEVICE request was sent.

Return value

Should return STATUS_SUCCESS or the error code that was returned from the attempt to perform the operation. If this routine returns failure, any pending IRP_MJ_CREATE requests between the IRP_MN_START_DEVICE request and the IRP_MN_STOP_DEVICE request will be failed. Do not return STATUS_PENDING.

Remarks

The minidriver specifies this routine's address in the PostStart member of its KSDEVICE_DISPATCH structure.

This routine is optional.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform Desktop
Header ks.h (include Ks.h)

See also

KSDEVICE_DISPATCH