IOCTL_PMI_GET_MEASUREMENT IOCTL (pmi.h)
A solicitação IOCTL_PMI_GET_MEASUREMENT retorna os dados de medida atuais de um medidor de energia.
Código principal
Buffer de entrada
O buffer de saída alocado pelo iniciador apontado pelo membro AssociatedIrp.SystemBuffer do IRP.
Comprimento do buffer de entrada
O membro Parameters.DeviceIoControl.OutputBufferLength do local de pilha de E/S atual do IRP (IO_STACK_LOCATION) é definido como o tamanho em bytes do buffer de saída alocado pelo iniciador apontado pelo membro AssociatedIrp.SystemBuffer do IRP. Esse tamanho deve ser maior ou igual a sizeof(PMI_MEASUREMENT_DATA) ou a solicitação falha com um erro status de STATUS_BUFFER_TOO_SMALL.
Buffer de saída
Se a solicitação for concluída com êxito, o buffer de saída apontado pelo membro AssociatedIrp.SystemBuffer conterá uma estrutura PMI_MEASUREMENT_DATA . Essa estrutura contém os dados de medida solicitados.
Comprimento do buffer de saída
O tamanho de uma estrutura PMI_MEASUREMENT_DATA .
Bloco de status
O membro Information é definido como o tamanho, em bytes, de uma estrutura PMI_MEASUREMENT_DATA .
O membro Status é definido como um dos seguintes valores:
STATUS_BUFFER_TOO_SMALL
O membro Parameters.DeviceIoControl.OutputBufferLength do IRP é menor que o tamanho, em bytes, de uma estrutura PMI_MEASUREMENT_DATA .
STATUS_SUCCESS
O driver WDM que dá suporte à interface PMI concluiu a solicitação IOCTL com êxito.
Comentários
A solicitação IOCTL_PMI_GET_MEASUREMENT consulta os dados de medida atuais do medidor de energia. Esses dados de medida são amostrados e médios com base nos parâmetros de configuração de medida do medidor de energia. Os parâmetros de configuração de medida são consultados por meio da solicitação IOCTL_PMI_GET_CONFIGURATION com um valor de PMI_CONFIGURATION_TYPE de entrada de PmiMeasurementConfiguration.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 7, Windows Server 2008 R2 e versões posteriores dos sistemas operacionais Windows. |
| Cabeçalho | pmi.h (inclua Pmi.h) |