PEP_REGISTER_DEVICE_V2 estrutura (pepfx.h)

A estrutura PEP_REGISTER_DEVICE_V2 descreve um dispositivo cuja pilha de driver acaba de se registrar na 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 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 de 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 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 pela 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 pela PoFx. A PoFx grava a estrutura PEP_DEVICE_REGISTER_V2 e os dados associados a essa estrutura antes de enviar a notificação PEP_DPM_REGISTER_DEVICE ao PEP. O conteúdo desse buffer permanecerá válido somente até que o PEP termine de manipular a notificação e retorne do retorno de chamada AcceptDeviceNotification .

Requisitos

   
Cliente mínimo com suporte Suporte para começar com Windows 10.
Cabeçalho pepfx.h (inclua Pep_x.h)

Confira também

AcceptDeviceNotification

PEP_DEVICE_ACCEPTANCE_TYPE

PEP_DEVICE_REGISTER_V2

PEP_DPM_REGISTER_DEVICE

UNICODE_STRING