estrutura DRIVER_PROXY_ENDPOINT_INFORMATION (wdm.h)

Observação

Essa estrutura é usada apenas para Driver Hot-Swap V1. Os novos drivers devem usar o Driver Hot-Swap V2, que manipula o registro de ponto de extremidade automaticamente por meio da enumeração de ponto de extremidade baseada em compilador.

A estrutura de DRIVER_PROXY_ENDPOINT_INFORMATION contém informações sobre uma função de ponto de extremidade DriverProxy que está sendo registrada para funcionalidades que podem ser trocadas em implementações do Driver Hot-Swap V1.

Sintaxe

typedef struct _DRIVER_PROXY_ENDPOINT_INFORMATION {
  DRIVER_PROXY_ENDPOINT_FUNCTION_ID Id;
  PDRIVER_PROXY_ENDPOINT_FUNCTION   EndpointFunction;
  ULONG                             ParameterCount;
} DRIVER_PROXY_ENDPOINT_INFORMATION, *PDRIVER_PROXY_ENDPOINT_INFORMATION;

Members

Id

Um identificador exclusivo para a função de ponto de extremidade. Essa ID é usada para identificar o ponto de extremidade dentro do sistema DriverProxy e deve ser exclusiva dentro do escopo da extensão DriverProxy. Se já existir um ponto de extremidade com a mesma ID, ele será substituído durante o registro, desde que a contagem de parâmetros corresponda.

EndpointFunction

Um ponteiro para o DRIVER_PROXY_ENDPOINT_FUNCTION que representa a função de ponto de extremidade a ser registrada. Essa é a função real que será tornada hot-swappable por meio do sistema DriverProxy.

ParameterCount

O número de parâmetros que a função de ponto de extremidade aceita. Esse valor é usado para validação durante o registro do ponto de extremidade. Se já existir um ponto de extremidade com a mesma ID, a contagem de parâmetros deverá corresponder exatamente ou o registro falhará com STATUS_INVALID_PARAMETER_3.

Observações

Essa estrutura é usada com IoRegisterDriverProxyEndpoints para registrar funções de ponto de extremidade em implementações do Driver Hot-Swap V1, que exigem registro manual. Cada estrutura na matriz descreve uma função de ponto de extremidade que deve ser tornada hot-swappable.

O driver Hot-Swap V2 descobre e registra pontos de extremidade automaticamente durante o processo de build, eliminando a necessidade dessa estrutura em implementações mais recentes.

Ao registrar vários pontos de extremidade, todos os pontos de extremidade na matriz são processados atomicamente. Todos os pontos de extremidade são registrados com êxito ou toda a operação falha e nenhuma alteração é feita.