UcmTcpciPortControllerCreate-Funktion (ucmtcpciportcontroller.h)
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 |
---|---|
|
Das Handle für ein Framework-Geräteobjekt ist ungültig. |
|
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 |