WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME, fonction (wdfiotarget.h)
[S’applique à KMDF et UMDF]
La fonction WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME initialise la structure WDF_IO_TARGET_OPEN_PARAMS d’un pilote afin que le pilote puisse ouvrir une cible d’E/S en spécifiant le nom de l’appareil, du fichier ou de l’interface du périphérique. Si le nom fourni n’existe pas, le système n’essaie pas de le créer.
Syntaxe
void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME(
[out] PWDF_IO_TARGET_OPEN_PARAMS Params,
[in] PCUNICODE_STRING TargetDeviceName,
[in] ACCESS_MASK DesiredAccess
);
Paramètres
[out] Params
Pointeur vers une structure de WDF_IO_TARGET_OPEN_PARAMS allouée par le pilote, que la fonction initialise.
[in] TargetDeviceName
Valeur du membre TargetDeviceName de la structure WDF_IO_TARGET_OPEN_PARAMS .
[in] DesiredAccess
Valeur du membre DesiredAccess de la structure WDF_IO_TARGET_OPEN_PARAMS .
Valeur de retour
None
Remarques
Si TargetDeviceName spécifie le nom d’un fichier qui existe déjà, le système ouvre le fichier existant. Si le fichier n’existe pas, l’opération d’ouverture échoue.
La structure WDF_IO_TARGET_OPEN_PARAMS est utilisée comme entrée de la méthode WdfIoTargetOpen .
La fonction WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME initialise les membres Size, Type, TargetDeviceName, DesiredAccess, CreateOptions et CreateDisposition de la structure WDF_IO_TARGET_OPEN_PARAMS spécifiée.
KMDF La fonction WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME initialise le membre CreateDisposition pour FILE_OPEN.
UMDF La fonction WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME initialise le membre CreateDisposition pour OPEN_EXISTING.
Pour plus d’informations sur les cibles d’E/S, consultez Utilisation de cibles d’E/S.
Exemples
Pour obtenir un exemple de code qui utilise WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME, consultez WdfIoTargetOpen.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfiotarget.h (inclure Wdf.h) |
| IRQL | N’importe quel niveau |
Voir aussi
WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME