Fungsi UfxFdoInit (ufxclient.h)

Menginisialisasi struktur WDFDEVICE_INIT yang kemudian disediakan driver klien saat memanggil WdfDeviceCreate.

Sintaks

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

Parameter

[in] WdfDriver

Handel ke objek driver WDF driver yang diperoleh driver dari panggilan sebelumnya ke WdfDriverCreate atau WdfGetDriver.

[in, out] DeviceInit

Penunjuk ke struktur WDFDEVICE_INIT .

[in, out] FdoAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan pemanggil yang menjelaskan atribut objek untuk

Nilai kembali

Jika operasi berhasil, metode mengembalikan STATUS_SUCCESS, atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE. Jika tidak, nilai status yang NT_SUCCESS(status) sama dengan FALSE.

Keterangan

Driver klien menerima penunjuk ke struktur WDFDEVICE_INIT yang dialokasikan kerangka kerja dalam fungsi panggilan balik EvtDriverDeviceAdd . Kemudian memanggil UfxFdoInit dengan pointer ini sebelum memanggil WdfDeviceCreate untuk membuat objek WDFDEVICE.

Secara default, untuk driver WDF, driver fungsi perangkat adalah pemilik kebijakan daya.

Cuplikan kode berikut menunjukkan cara memanggil 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
    //
    
    ...

}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10
Target Platform	Windows
Header	ufxclient.h
Pustaka	ufxstub.lib
IRQL	PASSIVE_LEVEL