UcmTcpciPortControllerCreate-Funktion (ucmtcpciportcontroller.h)

  • Artikel

Erstellt ein Portcontrollerobjekt, das bei UcmTcpciCx registriert werden soll.

Syntax

NTSTATUS UcmTcpciPortControllerCreate(
  WDFDEVICE                        WdfDevice,
  PUCMTCPCI_PORT_CONTROLLER_CONFIG Config,
  PWDF_OBJECT_ATTRIBUTES           Attributes,
  UCMTCPCIPORTCONTROLLER           *PortControllerObject
);

Parameter

WdfDevice

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

Config

Ein Zeiger auf die UCMTCPCI_PORT_CONTROLLER_CONFIG , die durch Aufrufen von UCMTCPCI_PORT_CONTROLLER_CONFIG_INIT initialisiert wird. Dieser Wert darf nicht NULL sein.

Attributes

Ein Zeiger auf eine WDF_OBJECT_ATTRIBUTES-Struktur , die vom Treiber bereitgestellte Attribute für das neue Objekt enthält. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

PortControllerObject

Ein Zeiger auf einen Speicherort, der ein Handle auf das neue Portcontrollerobjekt empfängt.

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_INVALID_DEVICE_REQUEST
 Das Handle für ein Framework-Geräteobjekt ist ungültig.
STATUS_INFO_LENGTH_MISMATCH
 Ungültige Größe für die Struktur, auf die von Config oder Config->Capabilities verwiesen wird. Muss die Größe UCMTCPCI_PORT_CONTROLLER_CONFIG bzw. UCMTCPCI_PORT_CONTROLLER_CAPABILITIES aufweisen.

Anforderungen

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

Weitere Informationen

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate