Méthode IWDFIoRequest2 ::GetCreateParametersEx (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 GetCreateParametersEx récupère les paramètres de création de fichier associés à un fichier en cours de création ou d’ouverture.

Syntaxe

void GetCreateParametersEx(
  [out, optional] ULONG       *pOptions,
  [out, optional] USHORT      *pFileAttributes,
  [out, optional] USHORT      *pShareAccess,
  [out, optional] ACCESS_MASK *pDesiredAccess
);

Paramètres

[out, optional] pOptions

Pointeur vers une variable allouée à l’appelant qui reçoit des indicateurs de bits qui indiquent les options de création de fichier. Ces indicateurs de bits nommés FILE_XXXX sont définis dans Wdm.h.

Les 24 bits de la variable indiquent les options à appliquer lors de la création ou de l’ouverture du fichier. Pour plus d’informations sur ces bits, consultez la description du paramètre CreateOptions de la fonction ZwCreateFile en mode noyau.

Les huit bits élevés de la variable indiquent les actions à effectuer si le fichier existe ou n’existe pas déjà. Pour plus d’informations sur ces bits, consultez la description du paramètre CreateDisposition de ZwCreateFile.

Ce paramètre est facultatif et peut être NULL.

[out, optional] pFileAttributes

Pointeur vers une variable allouée par l’appelant qui reçoit des indicateurs de bits qui indiquent des attributs de fichier. Ces indicateurs de bits nommés FILE_ATTRIBUTE_XXXX sont définis dans Wdm.h. Pour plus d’informations sur ces indicateurs de bits, consultez la description du paramètre FileAttributes de ZwCreateFile.

Ce paramètre est facultatif et peut être NULL.

[out, optional] pShareAccess

Pointeur vers une variable allouée par l’appelant qui reçoit des indicateurs de bits qui indiquent les options de partage de fichiers. Ces indicateurs de bits nommés FILE_SHARE_XXXX sont définis dans Wdm.h. Pour plus d’informations sur ces indicateurs de bits, consultez la description du paramètre ShareAccess de ZwCreateFile.

Ce paramètre est facultatif et peut être NULL.

[out, optional] pDesiredAccess

Pointeur vers une structure de ACCESS_MASK allouée à l’appelant qui spécifie l’accès demandé au fichier. Pour plus d’informations sur ce paramètre, consultez le paramètre DesiredAccess de ZwCreateFile.

Ce paramètre est facultatif et peut être NULL.

Valeur de retour

None

Remarques

Une fois que l’infrastructure a appelé la fonction de rappel IQueueCallbackCreate ::OnCreateFile d’un pilote, le pilote peut appeler la méthode IWDFIoRequest ::GetCreateParameters ou la méthode IWDFIoRequest2 ::GetCreateParametersEx pour obtenir les paramètres de création du fichier.

Pour plus d’informations, consultez Obtention de paramètres pour les demandes d’E/S.

Exemples

L’exemple de code suivant montre comment une fonction de rappel IQueueCallbackCreate ::OnCreateFile peut obtenir l’interface IWDFIoRequest2 , puis appeler GetCreateParametersEx.

VOID
OnCreateFile(
    __in IWDFIoQueue* FxQueue,
    __in IWDFIoRequest* FxRequest,
    __in IWDFFile* FxFile
    )
{
    ULONG fileOptions;
    USHORT fileAttributes,
    USHORT shareAccess,
    ACCESS_MASK desiredAccess;
    ...
    CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
    fxRequest2->GetCreateParametersEx(&fileOptions
                                      &fileAttributes,
                                      &shareAccess,
                                      &desiredAccess);
    ...
}

Configuration requise

Voir aussi

IQueueCallbackCreate ::OnCreateFile

IWDFIoRequest2

IWDFIoRequest ::GetCreateParameters