Funzione UcmTcpciDeviceInitialize (ucmtcpcidevice.h)

Articolo
02/07/2025

Inizializza l'estensione del framework UcmTcpciCx (Port Controller Interface) USB Type-C).

Sintassi

NTSTATUS UcmTcpciDeviceInitialize(
  WDFDEVICE               WdfDevice,
  PUCMTCPCI_DEVICE_CONFIG Config
);

Parametri

WdfDevice

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

Config

Puntatore a una struttura di UCMTCPCI_DEVICE_CONFIG fornita dal chiamante inizializzata chiamando UCMTCPCI_DEVICE_CONFIG_INIT. Questo valore non può essere NULL.

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_INFO_LENGTH_MISMATCH	Dimensioni non valide per la struttura a cui punta Config. Deve avere dimensioni di UCMTCPCI_DEVICE_CONFIG.
STATUS_INVALID_DEVICE_STATE	Lo stato Plug and Play dell'oggetto dispositivo framework non è inizializzato. Chiamare UcmTcpciDeviceInitialize nell'implementazione del driver di EVT_WDF_DRIVER_DEVICE_ADD.

Osservazioni

Il driver client deve chiamare UcmTcpciDeviceInitialize all'interno dell'implementazione del driver di EVT_WDF_DRIVER_DEVICE_ADD. Questo metodo configura l'oggetto dispositivo framework e alloca le risorse necessarie, esegue la registrazione per gli eventi PnP e configura le destinazioni di I/O.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10
server minimo supportato	Windows Server 2016
piattaforma di destinazione	Finestre
intestazione	ucmtcpcidevice.h
libreria	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

Vedere anche

WdfDeviceCreare

Condividi tramite