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 STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.
Bemerkungen
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 commits das Geräteobjekt, d. h. bevor er aus der EvtDriverDeviceAdd Rückruf zurückgibt oder der untergeordneten Liste des Controllers die PDO hinzufügt. Die untergeordnete Liste stellt die Geräte dar, die an den Bus angeschlossen sind. Weitere Informationen finden Sie unter Aufzählen der Geräte auf einem Bus-.
Nachdem SpbDeviceInitialize zurückgegeben wurde, ist der Controller bereit, E/A-Anforderungen zu verarbeiten, aber der SPB-Controllertreiber kann die Controllereinstellungen nach Bedarf weiterhin konfigurieren, bevor es das Geräteobjekt commits.
Wenn die Struktur, auf die Config verweist, nicht ordnungsgemäß ausgefüllt ist, löst Treiberüberprüfung einen Fehler aus. Weitere Informationen zu den Anforderungen für den Parameter Config finden Sie unter SPB_CONTROLLER_CONFIG.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Zielplattform- | Universal |
| Header- | spbcx.h |
| Library | Spbcxstubs.lib |
| IRQL- | PASSIVE_LEVEL |