Edit

PFNKSDEVICEQUERYCAPABILITIES callback function (ks.h)

  • Article

An AVStream minidriver's AVStrMiniDeviceQueryCapabilities routine is called when an IRP_MN_QUERY_CAPABILITIES is dispatched by the device.

Syntax

PFNKSDEVICEQUERYCAPABILITIES Pfnksdevicequerycapabilities;

NTSTATUS Pfnksdevicequerycapabilities(
  [in]      PKSDEVICE Device,
  [in]      PIRP Irp,
  [in, out] PDEVICE_CAPABILITIES Capabilities
)
{...}

Parameters

[in] Device

Pointer to the KSDEVICE that dispatched the IRP_MN_QUERY_CAPABILITIES.

[in] Irp

The IRP_MN_QUERY_CAPABILITIES issued by Device.

[in, out] Capabilities

Pointer to the DEVICE_CAPABILITIES structure that describes PnP and Power capabilities of Device.

Return value

Should return STATUS_SUCCESS or the error code that was returned from the attempt to perform the operation. Return success if providing query capabilities. If not, return an appropriate error code. Do not return STATUS_PENDING.

Remarks

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

This routine is called when an IRP_MN_QUERY_CAPABILITIES is dispatched by the device. It will usually be provided by minidrivers that need to supply information regarding power management capabilities. 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)
IRQL PASSIVE_LEVEL (See Remarks section)

See also

KSDEVICE

KSDEVICE_DISPATCH