структура DRIVER_PROXY_ENDPOINT_INFORMATION (wdm.h)

Структура DRIVER_PROXY_ENDPOINT_INFORMATION содержит сведения о функции конечной точки DriverProxy, которая регистрируется для функций с горячей заменой в реализации Driver Hot-Swap версии 1.

Синтаксис

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

Уникальный идентификатор функции конечной точки. Этот идентификатор используется для идентификации конечной точки в системе DriverProxy и должен быть уникальным в пределах расширения DriverProxy. Если конечная точка с тем же идентификатором уже существует, она будет заменена во время регистрации, при условии, что счетчик параметров соответствует.

EndpointFunction

Указатель на DRIVER_PROXY_ENDPOINT_FUNCTION , представляющий функцию конечной точки, которую необходимо зарегистрировать. Это фактическая функция, которая будет выполнена с возможностью горячего переключения через систему DriverProxy.

ParameterCount

Число параметров, которые принимает функция конечной точки. Это значение используется для проверки во время регистрации конечной точки. Если конечная точка с тем же идентификатором уже существует, число параметров должно совпадать точно, или регистрация завершится ошибкой с STATUS_INVALID_PARAMETER_3.

Замечания

Эта структура используется с IoRegisterDriverProxyEndpoints для регистрации функций конечных точек в реализации Driver Hot-Swap версии 1, для которых требуется ручная регистрация. Каждая структура в массиве описывает одну конечную функцию, которая должна быть выполнена с горячей заменой.

Драйвер Hot-Swap версии 2 автоматически обнаруживает и регистрирует конечные точки во время процесса сборки, устраняя необходимость этой структуры в более новых реализациях.

При регистрации нескольких конечных точек все конечные точки в массиве обрабатываются атомарно. Либо все конечные точки успешно зарегистрированы, либо вся операция завершается ошибкой, и изменения не вносятся.

Требования

См. также

IoRegisterDriverProxyEndpoints

DRIVER_PROXY_ENDPOINT_FUNCTION

DRIVER_PROXY_REGISTER_CALLBACK

IoCreateDriverProxyExtension

IoGetDriverProxyEndpointWrapper