NdisMGetDeviceProperty 函数 (ndis.h)

NdisMGetDeviceProperty 函数检索通过总线驱动程序设置与微型端口驱动程序通信所需的设备对象。

语法

void NdisMGetDeviceProperty(
  [in]            NDIS_HANDLE       MiniportAdapterHandle,
  [out, optional] PDEVICE_OBJECT    *PhysicalDeviceObject,
  [out, optional] PDEVICE_OBJECT    *FunctionalDeviceObject,
  [out, optional] PDEVICE_OBJECT    *NextDeviceObject,
  [out, optional] PCM_RESOURCE_LIST *AllocatedResources,
  [out, optional] PCM_RESOURCE_LIST *AllocatedResourcesTranslated
);

参数

[in] MiniportAdapterHandle

标识微型端口适配器的 NDIS 句柄。 此句柄最初传递到 MiniportInitializeEx 函数。

[out, optional] PhysicalDeviceObject

指向调用方分配的缓冲区的指针。 缓冲区接收指向表示微型端口适配器的物理设备的 DEVICE_OBJECT 结构的指针。 此指针是可选的。

[out, optional] FunctionalDeviceObject

指向调用方分配的缓冲区的指针。 缓冲区接收指向 DEVICE_OBJECT 结构的指针。 DEVICE_OBJECT 表示 NDIS 为物理设备创建的功能设备对象。 此指针是可选的。

[out, optional] NextDeviceObject

指向调用方分配的缓冲区的指针。 缓冲区接收指向表示下一个设备对象的 DEVICE_OBJECT 结构的指针。 此下一个设备对象位于链中,前面是属于微型端口驱动程序的功能设备对象。 NDIS 为物理设备创建此功能设备对象。 例如,下一个设备对象可以是与总线驱动程序关联的对象,或者 HAL 此指针是可选的。

[out, optional] AllocatedResources

指向调用方分配的缓冲区的指针,该缓冲区接收指向CM_RESOURCE_LIST结构的指针。 CM_RESOURCE_LIST描述了 PnP 管理器分配给物理设备的硬件资源列表。 此列表包含原始格式的资源,即 HAL 未翻译。 此指针是可选的。

[out, optional] AllocatedResourcesTranslated

指向调用方分配的缓冲区的指针,该缓冲区接收指向CM_RESOURCE_LIST结构的指针。 CM_RESOURCE_LIST描述了 PnP 管理器分配给物理设备的硬件资源列表。 此列表包含翻译形式的资源,即 HAL 翻译的资源。 此指针是可选的。

返回值

没有

言论

微型端口驱动程序必须检索特定信息才能设置其通信。 通过总线驱动程序进行通信的微型端口实例的微型端口驱动程序使用 NdisMGetDeviceProperty 来检索此信息。 例如,附加到通用串行总线(USB)或 IEEE 1394 总线的微型端口驱动程序实例要求在上边缘公开标准 NDIS 微型端口驱动程序接口的微型端口驱动程序实例,并使用其下边缘的特定总线的类接口。 若要使用 USB 或 1394 类接口,微型端口驱动程序将创建并提交 I/O 请求数据包(IRP)。 微型端口驱动程序使用物理和下一设备对象,这些对象 NdisMGetDeviceProperty 检索到特定总线的类接口。 若要查找有关创建 IRP 并将其提交到总线驱动程序的详细信息,请参阅 处理 IRP

指向 NdisMGetDeviceProperty 检索的物理、功能和下一个设备对象的 DEVICE_OBJECT 的指针只是微型端口驱动程序不透明的句柄。

微型端口驱动程序可以调用 NdisMGetDeviceProperty 来检索指向“raw”或“已翻译”资源的指针。 原始资源尚未由 HAL 翻译;已翻译的资源。 若要查找有关原始和已翻译资源的详细信息,请参阅 即插即用

要求

要求 价值
最低支持的客户端 在 NDIS 5.1 和 NDIS 6.0 及更高版本中受支持。 有关 NDIS 5.1 驱动程序,请参阅 NdisMGetDeviceProperty (NDIS 5.1)。
目标平台 普遍
标头 ndis.h (包括 Ndis.h)
Ndis.lib
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_Miniport_Driver_Function(ndis)

另请参阅

DEVICE_OBJECT

MiniportInitializeEx