UrsIoResourceListAppendDescriptor-Funktion (ursdevice.h)

Fügt den angegebenen Ressourcendeskriptor an das angegebene E/A-Ressourcenlistenobjekt an, das Ressourcendeskriptoren für die Host- oder Funktionsrolle verwaltet.

Syntax

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

Parameter

[in] IoResourceList

Das E/A-Ressourcenlistenobjekt einer Rolle, an das der Ressourcendeskriptor angefügt wird. Dieses Objekt wird vom Framework zugewiesen und an den Clienttreiber übergeben, wenn das Framework die EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS Implementierung des Treibers aufruft.

[in] Descriptor

Ein Zeiger auf IO_RESOURCE_DESCRIPTOR, der den Ressourcendeskriptor für die Rolle enthält.

Rückgabewert

Die Methode gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen entsprechenden NTSTATUS-Fehlercode zurück.

Hinweise

Nachdem der Clienttreiber UrsDeviceInitialize aufgerufen hat, weist das Framework Arbeitsspeicher für die Liste der Ressourcenanforderungen zu. Wenn die USB-Dual-Role-Klassenerweiterung die Implementierung von EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS des Clienttreibers aufruft, übergibt sie ein WDFIORESREQLIST-Handle an diese Anforderungsliste zusammen mit URSIORESLIST-Handles für Ressourcenlisten von Host- und Funktionsrollen. In der Implementierung wird erwartet, dass der Clienttreiber die Anforderungsliste aufzählt und den Ressourcendeskriptor (wenn er diese Ressource verwenden möchte) der Ressourcenliste für jede Rolle hinzu fügt.

Um eine Ressourcenbeschreibung für eine Rolle hinzuzufügen, ruft der Treiber UrsIoResourceListAppendDescriptor auf und gibt den Deskriptor und die Ressourcenliste an, der die Ressource hinzugefügt werden muss.

Ein Codebeispiel finden Sie unter EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS.

Weitere Informationen zu Ressourcenbedarfslisten finden Sie unter Behandeln von Hardwareressourcen.

Anforderungen

Weitere Informationen

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize