WdfFdoInitOpenRegistryKey, fonction (wdffdo.h)

[S’applique à KMDF et UMDF]

La méthode WdfFdoInitOpenRegistryKey ouvre la clé matérielle d’un appareil ou la clé logicielle d’un pilote dans le Registre et crée un objet de clé de registre d’infrastructure qui représente la clé de Registre.

Syntaxe

NTSTATUS WdfFdoInitOpenRegistryKey(
  [in]           PWDFDEVICE_INIT        DeviceInit,
  [in]           ULONG                  DeviceInstanceKeyType,
  [in]           ACCESS_MASK            DesiredAccess,
  [in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
  [out]          WDFKEY                 *Key
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT que le pilote a obtenue à partir de sa fonction de rappel EvtDriverDeviceAdd.

[in] DeviceInstanceKeyType

Spécifie la clé ou la sous-clé à ouvrir.

Il s’agit d’une or au niveau du bit des indicateurs suivants (qui sont définis dans Wdm.h).

[in] DesiredAccess

Valeur ACCESS_MASK-typée qui spécifie les droits d’accès demandés par le pilote pour la clé de Registre spécifiée.

Un pilote KMDF demande généralement KEY_READ, KEY_WRITEou KEY_READ | KEY_WRITE.

Si vous écrivez un pilote UMDF, utilisez le tableau suivant.

En guise de meilleure pratique, demandez uniquement les types d’accès dont votre pilote a besoin.

[in, optional] KeyAttributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES qui contient des attributs fournis par le pilote pour le nouvel objet de clé de Registre. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[out] Key

Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet de clé de Registre.

Valeur de retour

WdfFdoInitOpenRegistryKey retourne STATUS_SUCCESS si l’opération réussit. Sinon, la méthode peut retourner l’une des valeurs suivantes :

Pour obtenir la liste des autres valeurs de retour que la méthode WdfFdoInitOpenRegistryKey peut retourner, voir Framework Object Creation Errors.

La méthode peut également retourner d’autres valeurs NTSTATUS .

Remarques

Le pilote doit appeler WdfFdoInitOpenRegistryKey avant d’appeler WdfDeviceCreate. Pour plus d’informations sur l’appel WdfDeviceCreate, consultez Création d’un objet d’appareil Framework.

Pour plus d’informations sur la méthode WdfFdoInitOpenRegistryKey, consultez Création d’objets d’appareil dans undu pilote de fonction.

ou plus d’informations sur le Registre, les clés matérielles et logicielles et les objets de Registre, consultez Utilisation du Registre dans Framework-Based Pilotes.

Exemples

L’exemple de code suivant ouvre la clé matérielle d’un appareil, avec un accès en lecture.

WDFKEY key;
NTSTATUS status;

status = WdfFdoInitOpenRegistryKey(
                                   DeviceInit,
                                   PLUGPLAY_REGKEY_DEVICE,
                                   GENERIC_READ,
                                   WDF_NO_OBJECT_ATTRIBUTES,
                                   &key
                                   );
if (!NT_SUCCESS(status)) {
    return status;
}

Spécifications

Voir aussi

WdfDeviceOpenRegistryKey

WdfDriverOpenParametersRegistryKey