IWDFIoRequest ::GetCreateParameters, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode GetCreateParameters récupère les paramètres de requête d’une requête de type création.
Syntaxe
void GetCreateParameters(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess
);
Paramètres
[out, optional] pOptions
Pointeur vers une variable qui reçoit un masque de bits d’indicateurs qui spécifient les options appliquées lors de la création ou de l’ouverture du fichier associé à la requête et l’action à entreprendre si le fichier existe déjà.
Les 8 bits élevés de ce paramètre correspondent au paramètre CreateDisposition de la fonction ZwCreateFile en mode noyau. Ces 8 bits spécifient l’action à entreprendre, selon que le fichier existe déjà. Notez que ces valeurs de destruction diffèrent des valeurs utilisées dans le paramètre dwCreationDisposition de la fonction Win32 CreateFile.
Les 24 bits inférieurs de ce paramètre correspondent au paramètre createOptions de ZwCreateFile.
Ce paramètre est facultatif. Le pilote peut passer NULL si le pilote ne nécessite pas les informations.
[out, optional] pFileAttributes
Pointeur vers une variable qui reçoit un masque de bits d’indicateurs d’attribut appliqué lors de la création ou de l’ouverture du fichier associé à la requête. Les attributs spécifiés explicitement sont appliqués uniquement lorsque le fichier est créé, remplacé ou, dans certaines situations, remplacé. Par défaut, l’indicateur de FILE_ATTRIBUTE_NORMAL unique est spécifié. Toutefois, cet indicateur peut être substitué par n’importe quel autre indicateur ou par une combinaison or au niveau du bit d’indicateurs compatibles. Le masque de bits des indicateurs d’attribut correspond au paramètre FileAttributes de ZwCreateFile.
Ce paramètre est facultatif. Le pilote peut passer NULL si le pilote ne nécessite pas les informations.
[out, optional] pShareAccess
Pointeur vers une variable qui reçoit un masque de bits d’indicateurs qui spécifient les droits d’accès au partage demandés pour le fichier associé à la demande. Si le masque de bits reçu est égal à zéro, l’accès exclusif est demandé. Pour plus d’informations sur l’accès au partage, consultez la description du paramètre ShareAccess de ZwCreateFile.
Ce paramètre est facultatif. Le pilote peut passer NULL si le pilote ne nécessite pas les informations.
Valeur de retour
Aucun
Remarques
Bien que le pilote puisse éventuellement spécifier NULL pour chacun des pOptions, pFileAttributeset paramètres pShareAccess, le pilote doit spécifier au moins un paramètreNULL pour GetCreateParameters s’exécuter correctement.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |