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

Voir aussi

IWDFIoRequest

ZwCreateFile