Funzione UcmTcpciPortControllerCreate (ucmtcpciportcontroller.h)

  • Articolo

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