NdisFOidRequest 函数 (ndis.h)

筛选器驱动程序调用 NdisFOidRequest 函数以将 OID 请求转发到基础驱动程序或发起此类请求。

语法

NDIS_STATUS NdisFOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

[in] NdisFilterHandle

标识筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。

[in] OidRequest

指向 NDIS_OID_REQUEST 结构的指针，该结构指定使用给定的 OID_XXX 代码请求的操作。结构可以指定查询、集或方法请求。有关 OID 的详细信息，请参阅 NDIS OID。

请参阅 NdisOidRequest 函数。

筛选器驱动程序可以通过调用 NdisFOidRequest 向基础驱动程序发起 OID 请求。

筛选器驱动程序还可以筛选由过度分配驱动程序发起的 OID 请求。 NDIS 调用 FilterOidRequest 函数来处理每个此类请求。

如果 NdisFOidRequest 返回 NDIS_STATUS_PENDING，则 NDIS 会在基础驱动程序完成 OID 请求后调用 FilterOidRequestComplete 函数。

如果 NdisFOidRequest 返回NDIS_STATUS_SUCCESS，它将在 OidRequest 参数处的 NDIS_OID_REQUEST 结构中返回查询请求的结果。

如果筛选器驱动程序为NDIS_OID_REQUEST结构的“标头”字段中的“类型”和“大小”字段传递无效值，则 NdisFOidRequest 可以返回NDIS_STATUS_INVALID_PARAMETER。

当驱动程序处于“正在重启”、“正在运行”、“正在暂停”或“已暂停”状态时，驱动程序可以调用 NdisFOidRequest。