Funzione SerCx2InitializeDevice (sercx.h)

Articolo
10/30/2024

Il metodo SerCx2InitializeDevice termina l'inizializzazione dell'oggetto dispositivo framework per il controller seriale.

Sintassi

NTSTATUS SerCx2InitializeDevice(
  [in] WDFDEVICE      Device,
  [in] PSERCX2_CONFIG Config
);

Parametri

[in] Device

Handle WDFDEVICE per l'oggetto dispositivo framework che rappresenta il controller seriale. Per altre informazioni, vedere Osservazioni.

[in] Config

Puntatore a una struttura di SERCX2_CONFIG allocata dal chiamante che contiene puntatori a un set di funzioni di callback degli eventi implementate dal driver del controller seriale. La versione 2 del controller del framework seriale (SerCx2) chiama queste funzioni per configurare il controller seriale e per eseguire operazioni di base indipendenti dai tipi di transazione di I/O (PIO, system DMA o personalizzati) supportati dal driver.

Valore restituito

SerCx2InitializeDevice restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti di errore possibili includono i codici di stato seguenti.

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	Il metodo è stato chiamato in IRQL errato oppure il parametro device non è un handle WDFDEVICE valido.
STATUS_INFO_LENGTH_MISMATCH	Il valore dimensioniconfig non è uguale a sizeof(SERCX2_CONFIG).
STATUS_INVALID_PARAMETER	Il RequestAttributes membro non è valido o le funzioni di callback necessarie non sono presenti nell'elenco dei puntatori a funzione. Per altre informazioni, vedere Osservazioni.
STATUS_INSUFFICIENT_RESOURCES	Sono disponibili risorse insufficienti per eseguire l'operazione richiesta.

Osservazioni

Prima di chiamare questo metodo, il driver del controller seriale deve in precedenza aver chiamato il metodo serCx2InitializeDeviceInit.

Il driver del controller seriale deve chiamare questo metodo dal relativo EvtDriverDeviceAdd funzione di callback dopo aver creato un oggetto dispositivo framework per il controller seriale. Il driver chiama in genere un metodo come WdfDeviceCreate per creare l'oggetto dispositivo framework e ottenere un handle WDFDEVICE per questo oggetto.

Tre dei puntatori di funzione nella struttura SERCX2_CONFIG sono richiesti da SerCx2. Il driver deve implementare il EvtSerCx2PurgeFifos, EvtSerCx2Controle EvtSerCx2ApplyConfig funzioni di callback. In caso contrario, la chiamata SerCx2InitializeDevice ha esito negativo e restituisce STATUS_INVALID_PARAMETER.

Se l'RequestAttributes membro della struttura di SERCX2_CONFIG è impostato su un valore diverso da WDF_NO_OBJECT_ATTRIBUTES, il driver non deve sovrascrivere i valori scritti nel ParentObject, ExecutionLevele membri synchronizationScope di questa struttura dalla funzione WDF_OBJECT_ATTRIBUTES_INIT. In caso contrario, la chiamata SerCx2InitializeDevice ha esito negativo e restituisce STATUS_INVALID_PARAMETER.

Se il driver chiama il metodo WdfDeviceInitSetRequestAttributes per impostare gli attributi da utilizzare per gli oggetti richiesta, gli attributi della richiesta specificati in questa chiamata devono corrispondere agli attributi della richiesta specificati dal driver nella chiamata a SerCx2InitializeDevice. Per altre informazioni, vedere SerCx2 Custom-Receive Transactions e SerCx2 Custom-Transmit Transactions.