WdfIoResourceListGetDescriptor 方法

The WdfIoResourceListGetDescriptor method returns a pointer to a resource descriptor that is contained in a resource requirements list's logical configuration.

语法

PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
  [in]  WDFIORESLIST ResourceList,
  [in]  ULONG Index
);

参数

ResourceList [in]

A handle to a framework resource-range-list object that represents a logical configuration of hardware resources for a device.

Index [in]

A zero-based value that is used as an index into the logical configuration that ResourceList specifies.

返回值

WdfIoResourceListGetDescriptor returns a pointer to the IO_RESOURCE_DESCRIPTOR structure that describes the hardware resource that the Index parameter identifies, if the operation succeeds. Otherwise, the method returns NULL.

A system bug check occurs if the driver supplies an invalid object handle.

评论

Your driver cannot modify the contents of the IO_RESOURCE_DESCRIPTOR structure that WdfIoResourceListGetDescriptor retrieves. To modify a resource descriptor, the driver can call WdfIoResourceListUpdateDescriptor.

For more information about resource requirements lists and logical configurations, see Hardware Resources for Framework-Based Drivers.

示例

For a code example that uses WdfIoResourceListGetDescriptor, see WdfIoResourceRequirementsListGetIoResList.

要求

版本

Available in version 1.0 and later versions of KMDF.

标头

Wdfresource.h (包括Wdf.h)

Wdf<MajorVersionNumber>000.sys (see Framework Library Versions.)

IRQL

<=DISPATCH_LEVEL

另请参见

IO_RESOURCE_DESCRIPTOR
WdfIoResourceListUpdateDescriptor

 

 

社区附加资源

添加
显示:
© 2015 Microsoft