IOCTL_PMI_SET_CONFIGURATION IOCTL (pmi.h)

Artigo
08/07/2023

A solicitação IOCTL_PMI_SET_CONFIGURATION define os dados de configuração de um medidor de energia.

Código principal

Buffer de entrada

O membro AssociatedIrp.SystemBuffer do IRP (pacote de solicitação de E/S) aponta para um buffer de entrada alocado pelo iniciador que contém uma estrutura PMI_CONFIGURATION . Essa estrutura contém os dados de configuração.

Comprimento do buffer de entrada

O membro Parameters.DeviceIoControl.InputBufferLength do local da pilha de E/S atual do IRP (IO_STACK_LOCATION) é definido como o tamanho em bytes do buffer de entrada apontado pelo membro AssociatedIrp.SystemBuffer . Esse tamanho deve ser maior ou igual a sizeof(PMI_CONFIGURATION) ou a solicitação falha com um erro status de STATUS_BUFFER_TOO_SMALL.

Buffer de saída

Nenhum.

Comprimento do buffer de saída

Nenhum.

Bloco de status

O membro Information é definido como o tamanho, em bytes, de uma estrutura PMI_CONFIGURATION .

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_CONFIGURATION .

STATUS_SUCCESS

O driver WDM que dá suporte à interface PMI concluiu a solicitação IOCTL com êxito.

Comentários

A solicitação IOCTL_PMI_SET_CONFIGURATION define os parâmetros de configuração para o medidor de energia. O membro AssociatedIrp.SystemBuffer do IRP faz referência a um buffer que contém uma estrutura PMI_CONFIGURATION . O membro ConfigurationType dessa estrutura contém informações sobre o tipo de dados de configuração pmi a serem definidos no medidor de energia.

Somente os dados de configuração de PMI compatíveis com o medidor de energia com permissões de leitura/gravação podem ser alterados usando uma solicitação definida de IOCTL_PMI_SET_CONFIGURATION. Uma solicitação definida de IOCTL_PMI_SET_CONFIGURATION para alterar os dados de configuração do PMI somente leitura falhará e os dados não serão alterados no medidor de energia.

Nota A partir do Windows 7 e do Windows Server 2008 R2, o medidor de energia também pode dar suporte a permissões de leitura/gravação para suas informações de orçamento. Para obter mais informações, consulte PMI_REPORTED_CAPABILITIES.

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)