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