DRIVER_PROXY_ENDPOINT_INFORMATION结构 (wdm.h)

注释

此结构仅用于驱动程序 Hot-Swap V1。 新驱动程序应使用 Driver Hot-Swap V2,它通过基于编译器的终结点枚举自动处理终结点注册。

DRIVER_PROXY_ENDPOINT_INFORMATION结构包含有关在 Driver Hot-Swap V1 实现中为热交换功能注册的 DriverProxy 终结点函数的信息。

Syntax

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

终结点函数的唯一标识符。 此 ID 用于标识 DriverProxy 系统中的终结点,并且必须在 DriverProxy 扩展的范围内是唯一的。 如果已存在具有相同 ID 的终结点,则会在注册期间替换该终结点,前提是参数计数匹配。

EndpointFunction

指向表示要注册的终结点函数 的DRIVER_PROXY_ENDPOINT_FUNCTION 的指针。 这是通过 DriverProxy 系统进行热交换的实际函数。

ParameterCount

终结点函数接受的参数数。 此值用于在终结点注册期间进行验证。 如果已存在具有相同 ID 的终结点,则参数计数必须完全匹配,否则注册将失败 并STATUS_INVALID_PARAMETER_3

注解

此结构与 IoRegisterDriverProxyEndpoints 一起使用,用于在需要手动注册的 Driver Hot-Swap V1 实现中注册终结点函数。 数组中的每个结构都描述了应进行热交换的一个终结点函数。

驱动程序 Hot-Swap V2 在生成过程中自动发现和注册终结点,无需在较新的实现中使用此结构。

注册多个终结点时,会以原子方式处理数组中的所有终结点。 成功注册所有终结点,或者整个作失败,且未进行更改。

要求

Requirement 价值
Header wdm.h

另请参阅

IoRegisterDriverProxyEndpoints

DRIVER_PROXY_ENDPOINT_FUNCTION

DRIVER_PROXY_REGISTER_CALLBACK

IoCreateDriverProxyExtension

IoGetDriverProxyEndpointWrapper