Fonction UdecxWdfDeviceNeedsReset (udecxwdfdevice.h)

Article
02/29/2024

Informe l’extension de classe d’émulation de périphérique USB (UdeCx) que l’appareil a besoin d’une opération de réinitialisation.

Syntaxe

NTSTATUS UdecxWdfDeviceNeedsReset(
  [In] WDFDEVICE                   UdeWdfDevice,
  [In] UDECX_WDF_DEVICE_RESET_TYPE ResetType
);

Paramètres

[In] UdeWdfDevice

Handle d’un objet d’appareil framework qui représente un périphérique USB. Le pilote client a initialisé cet objet dans l’appel précédent à UdecxWdfDeviceAddUsbDeviceEmulation.

[In] ResetType

Valeur de type UDECX_WDF_DEVICE_RESET_TYPE qui indique le type de réinitialisation. Seul UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset est pris en charge pour l’instant.

Valeur retournée

La fonction retourne STATUS_SUCCESS si l’opération réussit. Sinon, retourne un code d’erreur NTSTATUS approprié.

Remarques

Si une opération de réinitialisation existante est en cours, la fonction échoue avec une erreur STATUS_DEVICE_BUSY. Notez que n’est UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset pris en charge qu’à l’heure actuelle. UdecxWdfDeviceResetAttemptFunctionLevelDeviceReset n’est pas pris en charge.

Configuration requise

Condition requise	Valeur
Version KMDF minimale	1,27 %
Version UMDF minimale	N/A
En-tête	udecxwdfdevice.h (inclure Udecx.h)
Bibliothèque	Udecxstub.lib
IRQL	PASSIVE_LEVEL

Voir aussi

UDECX_WDF_DEVICE_RESET_TYPE