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 |