Função de retorno de chamada PFNKSDEVICEQUERYCAPABILITIES (ks.h)
Uma rotina 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 pelo Dispositivo.
[in, out] Capabilities
Ponteiro para a estrutura DEVICE_CAPABILITIES que descreve as funcionalidades PnP e Power do Dispositivo.
Retornar valor
Deve retornar STATUS_SUCCESS ou o código de erro retornado da tentativa de executar a operação. Retornará êxito se fornecer recursos de consulta. Caso contrário, retorne um código de erro apropriado. Não retorne STATUS_PENDING.
Comentários
O minidriver especifica o endereço dessa rotina no membro QueryCapabilities de sua estrutura KSDEVICE_DISPATCH .
Essa rotina é chamada quando um IRP_MN_QUERY_CAPABILITIES é expedido pelo dispositivo. Normalmente, ele será fornecido por minidrivers que precisam fornecer informações sobre os recursos de gerenciamento de energia. Essa rotina é opcional.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ks.h (inclua Ks.h) |
| IRQL | PASSIVE_LEVEL (consulte a seção Comentários) |