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 Parameters.DeviceIoControl.OutputBufferLength membro do local da 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 tamanho de(PMI_MEASUREMENT_DATA) ou a solicitação falhar com um status de erro 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 contém 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 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.
Observações
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 mediados com base nos parâmetros de configuração de medição 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 7, Windows Server 2008 R2 e versões posteriores dos sistemas operacionais Windows. |
| cabeçalho | pmi.h (inclua Pmi.h) |