Função de retorno de chamada PFNKSDEVICEQUERYCAPABILITIES (ks.h)
A rotina de de AVStrMiniDeviceQueryCapabilities de um minidriver AVStream é chamada quando um IRP_MN_QUERY_CAPABILITIES é expedido pelo dispositivo.
Sintaxe
PFNKSDEVICEQUERYCAPABILITIES Pfnksdevicequerycapabilities;
NTSTATUS Pfnksdevicequerycapabilities(
[in] PKSDEVICE Device,
[in] PIRP Irp,
[in, out] PDEVICE_CAPABILITIES Capabilities
)
{...}
Parâmetros
[in] Device
Ponteiro para o KSDEVICE que despachou o IRP_MN_QUERY_CAPABILITIES.
[in] Irp
O IRP_MN_QUERY_CAPABILITIES emitido por Device.
[in, out] Capabilities
Ponteiro para a estrutura de DEVICE_CAPABILITIES que descreve os recursos PnP e Power de Device.
Valor de retorno
Deve retornar STATUS_SUCCESS ou o código de erro retornado da tentativa de executar a operação. Retornará êxito ao fornecer recursos de consulta. Caso contrário, retorne um código de erro apropriado. Não retorne STATUS_PENDING.
Observações
O minidriver especifica o endereço dessa rotina no queryCapabilities membro de sua estrutura KSDEVICE_DISPATCH.
Essa rotina é chamada quando um IRP_MN_QUERY_CAPABILITIES é expedido pelo dispositivo. Geralmente, ele será fornecido por minidrivers que precisam fornecer informações sobre os recursos de gerenciamento de energia. Essa rotina é opcional.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ks.h (incluir Ks.h) |
| IRQL | PASSIVE_LEVEL (seção Ver Comentários) |