Compartilhar via


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)

Confira também

KSDEVICE

KSDEVICE_DISPATCH