estrutura PEP_REGISTER_DEVICE_V2 (pep_x.h)

Artigo
02/26/2024

A estrutura PEP_REGISTER_DEVICE_V2 descreve um dispositivo cuja pilha de driver acabou de ser registrada com a PoFx ( estrutura de gerenciamento de energia ) do Windows.

Sintaxe

typedef struct _PEP_REGISTER_DEVICE_V2 {
  [in]  PCUNICODE_STRING           DeviceId;
  [in]  POHANDLE                   KernelHandle;
  [in]  PPEP_DEVICE_REGISTER_V2    Register;
  [out] PEPHANDLE                  DeviceHandle;
  [out] PEP_DEVICE_ACCEPTANCE_TYPE DeviceAccepted;
} PEP_REGISTER_DEVICE_V2, *PPEP_REGISTER_DEVICE_V2;

Membros

[in] DeviceId

Uma cadeia de caracteres que identifica exclusivamente o dispositivo. Esse membro é um ponteiro para uma estrutura UNICODE_STRING que contém uma cadeia de caracteres de identificação do dispositivo.

[in] KernelHandle

Um valor POHANDLE que representa o registro do dispositivo com PoFx. O PEP (plug-in de extensão de plataforma) recebeu anteriormente esse identificador da PoFx durante a notificação de PEP_DPM_REGISTER_DEVICE que informou ao PEP que a pilha de driver do dispositivo registrou o dispositivo com PoFx.

[in] Register

Um ponteiro para uma estrutura PEP_DEVICE_REGISTER_V2 que descreve os atributos de gerenciamento de energia de todos os componentes no dispositivo. Para obter mais informações, consulte Comentários.

[out] DeviceHandle

Um valor PEPHANDLE que o PEP cria para identificar esse dispositivo. A PoFx usará esse identificador para identificar o dispositivo em futuras notificações de DPM (gerenciamento de energia do dispositivo).

[out] DeviceAccepted

Um PEP_DEVICE_ACCEPTANCE_TYPE valor de enumeração que indica se o PEP declara a propriedade do dispositivo. O PEP que declara a propriedade é responsável por lidar com as notificações do DPM para o dispositivo.

Comentários

Essa estrutura é usada pela notificação PEP_DPM_REGISTER_DEVICE . Os três primeiros membros dessa estrutura contêm valores de entrada fornecidos pelo PoFx. Os dois últimos membros contêm valores de saída que o PEP grava na estrutura em resposta a essa notificação.

O membro Register contém um ponteiro para um buffer de entrada alocado pelo PoFx. O PoFx grava a estrutura de PEP_DEVICE_REGISTER_V2 e os dados associados a essa estrutura antes de enviar a notificação de PEP_DPM_REGISTER_DEVICE para o PEP. O conteúdo desse buffer permanece válido somente até que o PEP termine de manipular a notificação e retorne do retorno de chamada AcceptDeviceNotification .