struktura WDFDEVICE_INIT

[Dotyczy usług KMDF i UMDF]

Struktura WDFDEVICE_INIT jest nieprzezroczystą strukturą zdefiniowaną i przydzieloną przez platformę.

Składnia

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

Członkowie

Sterowniki funkcji i filtru otrzymują wskaźnik do tej struktury jako dane wejściowe do EvtDriverDeviceAdd funkcji wywołania zwrotnego lub jako wartość zwracaną z WdfControlDeviceInitAllocate.

Kierowcy magistrali otrzymują wskaźnik struktury jako dane wejściowe do EvtChildListCreateDevice funkcji wywołania zwrotnego lub jako wartość zwracaną z WdfPdoInitAllocate.

Gdy sterownik otrzyma strukturę WDFDEVICE_INIT, przekazuje wskaźnik struktury do funkcji inicjowania. Te funkcje używają struktury WDFDEVICE_INIT do przechowywania informacji używanych przez platformę do tworzenia obiektu urządzenia struktury.

Aby znaleźć dokumentację metod inicjowania urządzeń, zobacz wdfdevice.h header.

Po wywołaniu funkcji inicjowania sterownik musi wywołać WdfDeviceUtwórz, aby utworzyć obiekt urządzenia struktury.

Jeśli sterownik odebrał strukturę WDFDEVICE_INIT z wywołania do WdfPdoInitAllocate lub WdfControlDeviceInitAllocate, a jeśli sterownik otrzymuje błąd podczas wywoływania funkcji inicjowania, sterownik musi wywołać WdfDeviceInitFree zamiast WdfDeviceCreate.

Sterownik nie może wywołać WdfDeviceInitFree po pomyślnym wywołaniu usługi WdfDeviceUtwórz.

Struktura WDFDEVICE_INIT jest dostępna w wersji 1.0 lub nowszej usługi KMDF.

Wymagania