Méthode IWDFIoRequest ::GetCreateParameters (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]
La méthode GetCreateParameters récupère les paramètres de requête pour une demande de type create.
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 demande 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 disposition diffèrent des valeurs utilisées dans le paramètre dwCreationDisposition de la fonction CreateFile Win32.
Les 24 bits de ce paramètre correspondent au paramètre CreateOptions de ZwCreateFile.
Ce paramètre est facultatif. Le pilote peut passer la valeur NULL si le pilote n’a pas besoin des 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 demande. Les attributs explicitement spécifiés ne sont appliqués que lorsque le fichier est créé, remplacé ou, dans certains cas, remplacé. Par défaut, l’indicateur de FILE_ATTRIBUTE_NORMAL unique est spécifié. Toutefois, cet indicateur peut être remplacé par n’importe quel autre indicateur ou par une combinaison de bits OU 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 la valeur NULL si le pilote n’a pas besoin des 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 de 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 la valeur NULL si le pilote n’a pas besoin des informations.
Valeur de retour
None
Remarques
Bien que le pilote puisse éventuellement spécifier NULL pour chacun des paramètres pOptions, pFileAttributes et pShareAccess , le pilote doit spécifier au moins un paramètre non NULL pour que GetCreateParameters s’exécute correctement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge | Non disponible dans UMDF 2.0 et versions ultérieures. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| Version UMDF minimale | 1.5 |
| En-tête | wudfddi.h (inclure Wudfddi.h) |
| DLL | WUDFx.dll |