fonction WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME (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 de 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 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
Aucun
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 dans la méthode WdfIoTargetOpen.
La fonction WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME initialise la taille, Type, TargetDeviceName, DesiredAccess, CreateOptionset les membres 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 à FILE_OPEN.
UMDF La fonction WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME initialise le membre CreateDisposition à OPEN_EXISTING.
Pour plus d’informations sur les cibles d’E/S, consultez Utilisation des cibles d’E/S.
Exemples
Pour obtenir un exemple de code qui utilise WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME, consultez WdfIoTargetOpen.
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| En-tête | wdfiotarget.h (include Wdf.h) |
| IRQL | N’importe quel niveau |
Voir aussi
WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME