UcmTcpciDeviceInitialize-Funktion (ucmtcpcidevice.h)

  • Artikel

Initialisiert die USB Type-C Port Controller Interface-Frameworkerweiterung (UcmTcpciCx).

Syntax

NTSTATUS UcmTcpciDeviceInitialize(
  WDFDEVICE               WdfDevice,
  PUCMTCPCI_DEVICE_CONFIG Config
);

Parameter

WdfDevice

Ein Handle für ein Framework-Geräteobjekt, das der Clienttreiber im vorherigen Aufruf von WdfDeviceCreate empfangen hat.

Config

Ein Zeiger auf eine vom Aufrufer bereitgestellte UCMTCPCI_DEVICE_CONFIG-Struktur , die durch Aufrufen von UCMTCPCI_DEVICE_CONFIG_INIT initialisiert wird. Dieser Wert darf nicht NULL sein.

Rückgabewert

(NTSTATUS) Die -Methode gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.

Rückgabecode Beschreibung
STATUS_INFO_LENGTH_MISMATCH
 Ungültige Größe für die Struktur, auf die die Konfiguration verweist. Die Größe muss UCMTCPCI_DEVICE_CONFIG sein.
STATUS_INVALID_DEVICE_STATE
 Der Plug & Play Zustand des Frameworkgeräteobjekts wird nicht initialisiert. Rufen Sie UcmTcpciDeviceInitialize innerhalb der Treiberimplementierung von EVT_WDF_DRIVER_DEVICE_ADD auf.

Hinweise

Der Clienttreiber muss UcmTcpciDeviceInitialize innerhalb der Treiberimplementierung von EVT_WDF_DRIVER_DEVICE_ADD aufrufen. Diese Methode konfiguriert das Frameworkgeräteobjekt und ordnet erforderliche Ressourcen zu, registriert sich für PnP-Ereignisse und richtet E/A-Ziele ein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
Kopfzeile ucmtcpcidevice.h
Bibliothek Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

WdfDeviceCreate