WdfIoResourceListCreate メソッド

The WdfIoResourceListCreate method creates an empty logical configuration, which can be populated and added to a resource requirements list.

構文

NTSTATUS WdfIoResourceListCreate(
  [in]            WDFIORESREQLIST RequirementsList,
  [in, optional]  PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]           WDFIORESLIST *ResourceList
);

パラメーター

RequirementsList [in]

A handle to a framework resource-requirements-list object that represents a device's resource requirements list.

Attributes [in, optional]

A pointer to a caller-allocated WDF_OBJECT_ATTRIBUTES structure that contains attributes for the new object. (The structure's ParentObject member must be NULL.) This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.

ResourceList [out]

A handle to a framework resource-range-list object that represents the new logical configuration.

戻り値

WdfIoResourceListCreate returns STATUS_SUCCESS if the operation succeeds.

For additional return values, see Framework Object Creation Errors.

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

解説

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

The caller-specified resource-requirements-list object becomes the parent of the new resource-range-list object. The driver cannot change this parent, and the ParentObject member or the WDF_OBJECT_ATTRIBUTES structure must be NULL.

For a code example that uses WdfIoResourceListCreate, see WdfIoResourceRequirementsListAppendIoResList.

要件

バージョン

Available in version 1.0 and later versions of KMDF.

ヘッダー

Wdfresource.h (includeWdf.h)

ライブラリ

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

IRQL

<=DISPATCH_LEVEL

参照

WDF_OBJECT_ATTRIBUTES

 

 

コミュニティの追加

追加
表示:
© 2015 Microsoft