Функция обратного вызова PFNKSDEVICEQUERYCAPABILITIES (ks.h)
Подпрограмма AVStrMiniDeviceQueryCapabilities avStream minidriver вызывается, когда устройство отправляет IRP_MN_QUERY_CAPABILITIES .
Синтаксис
PFNKSDEVICEQUERYCAPABILITIES Pfnksdevicequerycapabilities;
NTSTATUS Pfnksdevicequerycapabilities(
[in] PKSDEVICE Device,
[in] PIRP Irp,
[in, out] PDEVICE_CAPABILITIES Capabilities
)
{...}
Параметры
[in] Device
Указатель на KSDEVICE , отправившей IRP_MN_QUERY_CAPABILITIES.
[in] Irp
IRP_MN_QUERY_CAPABILITIES, выданный устройством.
[in, out] Capabilities
Указатель на структуру DEVICE_CAPABILITIES, описывающую возможности PnP и питания устройства.
Возвращаемое значение
Должен возвращать STATUS_SUCCESS или код ошибки, возвращенный при попытке выполнить операцию. Если предоставляются возможности запросов, возвращается успешное выполнение. Если нет, верните соответствующий код ошибки. Не возвращайте STATUS_PENDING.
Комментарии
Мини-диск указывает адрес этой подпрограммы в элементе QueryCapabilities структуры KSDEVICE_DISPATCH .
Эта подпрограмма вызывается, когда устройство отправляет IRP_MN_QUERY_CAPABILITIES . Обычно они предоставляются мини-накопителями, которым необходимо предоставить сведения о возможностях управления питанием. Эта подпрограмма является необязательной.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях. |
Целевая платформа | Персональный компьютер |
Верхняя часть | ks.h (включая Ks.h) |
IRQL | PASSIVE_LEVEL (см. раздел "Примечания") |