AVStrMiniDeviceQueryStop routine

An AVStream minidriver's AVStrMiniDeviceQueryStop routine is called when it receives an IRP_MN_QUERY_STOP_DEVICE request.

Syntax

PFNKSDEVICEIRP AVStrMiniDeviceQueryStop;

NTSTATUS AVStrMiniDeviceQueryStop(
  _In_ PKSDEVICE Device,
  _In_ PIRP      Irp
)
{ ... }

Parameters

  • Device [in]
    Pointer to the KSDEVICE that dispatched the IRP_MN_QUERY_STOP_DEVICE.

  • Irp [in]
    The IRP_MN_QUERY_STOP_DEVICE issued by Device.

Return value

Should return STATUS_SUCCESS or the error code that was returned from the attempt to perform the operation. Success indicates that the device can commit to a stop and an error code indicates that it cannot. Do not return STATUS_PENDING.

Remarks

The minidriver specifies a pointer to this routine in the QueryStop member of its KSDEVICE_DISPATCH structure.

Use AVStrMiniQueryStop to prevent the stopping of the device or to disallow activity that would prevent the minidriver from committing to a stop operation. If this routine is not specified, AVStream assumes that the minidriver can commit to a stop operation.

This routine is optional.

Requirements

Target platform

Desktop

Version

Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.

Header

Ks.h (include Ks.h)

See also

KSDEVICE_DISPATCH

KSDEVICE

 

 

Send comments about this topic to Microsoft