estrutura PEP_REGISTER_DEVICE_V2 (pep_x.h)

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

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 de 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 notificações futuras DPM (gerenciamento de energia de dispositivo).

[out] DeviceAccepted

Um valor de enumeração PEP_DEVICE_ACCEPTANCE_TYPE 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.

Observações

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 Registrar contém um ponteiro para um buffer de entrada alocado pela PoFx. A 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 ao PEP. O conteúdo desse buffer permanece válido somente até que o PEP termine de lidar com a notificação e retorne do AcceptDeviceNotification retorno de chamada.

Requisitos

Consulte também

AcceptDeviceNotification

PEP_DEVICE_ACCEPTANCE_TYPE

PEP_DEVICE_REGISTER_V2

PEP_DPM_REGISTER_DEVICE

UNICODE_STRING