UfxFdoInit-Funktion (ufxclient.h)

Initialisiert die WDFDEVICE_INIT-Struktur, die der Clienttreiber anschließend bereitstellt, wenn er WdfDeviceCreate aufruft.

Syntax

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

Parameter

[in] WdfDriver

Ein Handle für das WDF-Treiberobjekt des Treibers, das der Treiber aus einem vorherigen Aufruf von WdfDriverCreate oder WdfGetDriver abgerufen hat.

[in, out] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT-Struktur .

[in, out] FdoAttributes

Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES-Struktur , die Objektattribute für die

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode STATUS_SUCCESS oder einen anderen status Wert zurück, für den NT_SUCCESS(status) true entspricht. Andernfalls wird ein status Wert zurückgegeben, für den NT_SUCCESS(status) false entspricht.

Hinweise

Der Clienttreiber empfängt in seiner Rückruffunktion EvtDriverDeviceAdd einen Zeiger auf eine vom Framework zugewiesene WDFDEVICE_INIT Struktur. Anschließend wird UfxFdoInit mit diesem Zeiger aufgerufen, bevor WdfDeviceCreate aufgerufen wird, um das WDFDEVICE-Objekt zu erstellen.

Standardmäßig ist für WDF-Treiber der Funktionstreiber des Geräts der Besitzer der Energierichtlinie.

Der folgende Codeausschnitt zeigt, wie UfxFdoInit aufgerufen wird.

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
    //
    
    ...

}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Zielplattform	Windows
Kopfzeile	ufxclient.h
Bibliothek	ufxstub.lib
IRQL	PASSIVE_LEVEL