Funzione UcmTcpciPortControllerCreate (ucmtcpciportcontroller.h)

Articolo
02/26/2024

Crea un oggetto controller di porta da registrare con UcmTcpciCx.

Sintassi

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

Parametri

WdfDevice

Handle a un oggetto dispositivo framework ricevuto dal driver client nella chiamata precedente a WdfDeviceCreate.

Config

Puntatore al UCMTCPCI_PORT_CONTROLLER_CONFIG inizializzato chiamando UCMTCPCI_PORT_CONTROLLER_CONFIG_INIT. Questo valore non può essere NULL.

Attributes

Puntatore a una struttura WDF_OBJECT_ATTRIBUTES contenente attributi forniti dal driver per il nuovo oggetto. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.

PortControllerObject

Puntatore a una posizione che riceve un handle per il nuovo oggetto controller di porta.

Valore restituito

(NTSTATUS) Il metodo restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire un codice di errore NTSTATUS appropriato.

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	L'handle in un oggetto dispositivo framework non è valido.
STATUS_INFO_LENGTH_MISMATCH	Dimensioni non valide per la struttura a cui fa riferimento Config o Config->Capabilities. Devono essere dimensioni di UCMTCPCI_PORT_CONTROLLER_CONFIG o UCMTCPCI_PORT_CONTROLLER_CAPABILITIES rispettivamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Intestazione	ucmtcpciportcontroller.h
Libreria	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

Vedi anche

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate

Condividi tramite