UcmTcpciPortControllerCreate-Funktion (ucmtcpciportcontroller.h)

Erstellt ein Portcontrollerobjekt zum Registrieren bei UcmTcpciCx.

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 WdfDeviceCreateempfangen hat.

Config

Ein Zeiger auf die UCMTCPCI_PORT_CONTROLLER_CONFIG, die durch Aufrufen von UCMTCPCI_PORT_CONTROLLER_CONFIG_INITinitialisiert 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_ATTRIBUTESwerden.

PortControllerObject

Ein Zeiger auf eine Position, die ein Handle für 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 durch Config oder Config->Capabilitiesverwiesen wird. Muss die Größe UCMTCPCI_PORT_CONTROLLER_CONFIG bzw. UCMTCPCI_PORT_CONTROLLER_CAPABILITIESsein.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 10
mindestens unterstützte Server- Windows Server 2016
Zielplattform- Fenster
Header- ucmtcpciportcontroller.h
Library Ucmtcpcicxstub.lib
IRQL- PASSIVE_LEVEL

Siehe auch

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate

  • Last updated on