共用方式為


UrsIoResourceListAppendDescriptor 函式 (ursdevice.h)

將指定的資源描述元附加至指定的 I/O 資源清單物件,以維護主機或函式角色的資源描述項。

語法

NTSTATUS UrsIoResourceListAppendDescriptor(
  [in] URSIORESLIST            IoResourceList,
  [in] PIO_RESOURCE_DESCRIPTOR Descriptor
);

參數

[in] IoResourceList

附加資源描述元的角色 I/O 資源清單物件。 當架構叫用驅動程式 的EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS 實作時,架構會配置此物件並傳遞至用戶端驅動程式。

[in] Descriptor

包含角色之資源描述項的IO_RESOURCE_DESCRIPTOR指標。

傳回值

如果作業成功,方法會傳回STATUS_SUCCESS。 否則,這個方法可能會傳回適當的 NTSTATUS 錯誤碼。

備註

在客戶端驅動程式呼叫 UrsDeviceInitialize 之後,架構會為 資源需求清單配置記憶體。 當 USB 雙重角色類別延伸模組叫用用戶端驅動程式 的EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS實作時,它會將 WDFIORESREQLIST 句柄傳遞給該需求清單,以及主機和函式角色 資源清單的 URSIORESLIST 句柄。 在實作中,用戶端驅動程式預期會透過需求清單列舉,並在想要使用該資源) 至每個角色的資源清單時,將資源描述元新增 (。

若要新增角色的資源描述項,驅動程式會呼叫 UrsIoResourceListAppendDescriptor ,並指定必須新增資源的描述元和資源清單。

如需程式代碼範例,請參閱 EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

如需資源需求清單的詳細資訊,請參閱 處理硬體資源

規格需求

需求
最低支援的用戶端 Windows 10
最低支援的伺服器 Windows Server 2016
目標平台 Windows
最低 KMDF 版本 1.15
標頭 ursdevice.h (包含 Urscx.h)
程式庫 Urscxstub.lib
IRQL PASSIVE_LEVEL

另請參閱

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize