Funzione UcmTcpciDeviceInitialize (ucmtcpcidevice.h)

Articolo
02/29/2024

Inizializza l'estensione del framework di interfaccia del controller di porta USB Type-C (UcmTcpciCx).

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 essere una dimensione 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.

Commenti

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

Requisiti

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

Vedi anche

WdfDeviceCreate

Condividi tramite