Fonction UfxFdoInit (ufxclient.h)

Article
02/26/2024

Initialise la structure WDFDEVICE_INIT que le pilote client fournit par la suite lorsqu’il appelle WdfDeviceCreate.

Syntaxe

NTSTATUS UfxFdoInit(
  [in]      WDFDRIVER              WdfDriver,
  [in, out] PWDFDEVICE_INIT        DeviceInit,
  [in, out] PWDF_OBJECT_ATTRIBUTES FdoAttributes
);

Paramètres

[in] WdfDriver

Handle de l’objet de pilote WDF du pilote que le pilote a obtenu à partir d’un appel précédent à WdfDriverCreate ou WdfGetDriver.

[in, out] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT .

[in, out] FdoAttributes

Pointeur vers une structure de WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui décrit les attributs d’objet pour le

Valeur retournée

Si l’opération réussit, la méthode retourne STATUS_SUCCESS ou une autre valeur status pour laquelle NT_SUCCESS(status) est égal à TRUE. Sinon, il retourne une valeur status pour laquelle NT_SUCCESS(status) est FALSE.

Remarques

Le pilote client reçoit un pointeur vers une structure de WDFDEVICE_INIT allouée par l’infrastructure dans sa fonction de rappel EvtDriverDeviceAdd . Il appelle ensuite UfxFdoInit avec ce pointeur avant d’appeler WdfDeviceCreate pour créer l’objet WDFDEVICE.

Par défaut, pour les pilotes WDF, le pilote de fonction de l’appareil est le propriétaire de la stratégie d’alimentation.

L’extrait de code suivant montre comment appeler UfxFdoInit.

NTSTATUS
UfxClientDeviceCreate(
    _In_ WDFDRIVER Driver,
    _In_ PWDFDEVICE_INIT DeviceInit
    )
/*++

Routine Description:

    Worker routine called to create a device and its software resources.

Arguments:

    Driver - WDF driver object

    DeviceInit - Pointer to an opaque init structure. Memory for this
                 structure will be freed by the framework when WdfDeviceCreate
                 succeeds. So don't access the structure after that point.

Return Value:

    Appropriate NTSTATUS value

--*/
{
    WDF_OBJECT_ATTRIBUTES DeviceAttributes;
    WDFDEVICE WdfDevice;

    PAGED_CODE();

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&DeviceAttributes, CONTROLLER_CONTEXT);

    //
    // Do UFX-specific initialization
    //
    Status = UfxFdoInit(Driver, DeviceInit, &DeviceAttributes);

    //
    // Proceed to WdfDeviceCreate
    //
    
    ...

}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Plateforme cible	Windows
En-tête	ufxclient.h
Bibliothèque	ufxstub.lib
IRQL	PASSIVE_LEVEL

Partager via