注释
此结构仅用于驱动程序 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