SpbDeviceInitialize-Funktion (spbcx.h)

Die SpbDeviceInitialize-Methode schließt die Initialisierung des SPB-Controllertreibers ab, nachdem dieser Treiber das zugeordnete Geräteobjekt erstellt hat.

Syntax

NTSTATUS SpbDeviceInitialize(
  [in] WDFDEVICE              FxDevice,
  [in] PSPB_CONTROLLER_CONFIG Config
);

Parameter

[in] FxDevice

Ein WDFDEVICE-Handle für das Geräteobjekt, das den SPB-Controller darstellt.

[in] Config

Ein Zeiger auf eine SPB_CONTROLLER_CONFIG Struktur, die die Gerätekonfigurationsinformationen für den SPB-Controllertreiber enthält. Diese Struktur muss von der SPB_CONTROLLER_CONFIG_INIT-Funktion initialisiert worden sein.

Rückgabewert

SpbDeviceInitialize gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Ihr SPB-Controllertreiber ruft diese Methode auf, um seine Ereignisrückruffunktionen bei der SPB-Frameworkerweiterung (SpbCx) zu registrieren und den Übertragungsmodus anzugeben, der für die E/A-Warteschlange des Controllers verwendet werden soll. SpbDeviceInitialize erstellt alle internen Datenstrukturen des Controllers, einschließlich der E/A-Warteschlange.

Der SPB-Controllertreiber muss diese Methode aufrufen, bevor er einen Commit für das Geräteobjekt durchführt, d. h. bevor er aus dem EvtDriverDeviceAdd-Rückruf zurückgibt oder den PDO der untergeordneten Liste des Controllers hinzufügt. Die untergeordnete Liste stellt die Geräte dar, die an den Bus angefügt sind. Weitere Informationen finden Sie unter Auflisten der Geräte in einem Bus.

Nachdem SpbDeviceInitialize zurückgegeben wurde, ist der Controller bereit, E/A-Anforderungen zu verarbeiten, aber der SPB-Controllertreiber kann bei Bedarf die Controllereinstellungen konfigurieren, bevor er das Geräteobjekt committet.

Wenn die Struktur, auf die von Config verwiesen wird, nicht ordnungsgemäß ausgefüllt ist, löst driver verifier einen Fehler aus. Weitere Informationen zu den Anforderungen für den Config-Parameter finden Sie unter SPB_CONTROLLER_CONFIG.

Anforderungen

Weitere Informationen

EvtChildListCreateDevice

EvtDriverDeviceAdd

SPB_CONTROLLER_CONFIG

SPB_CONTROLLER_CONFIG_INIT