PFNKSDEVICEQUERYCAPABILITIES callback function (ks.h)
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) |