Funzione SerCxDeviceInitConfig (sercx.h)

Articolo
12/13/2024

Il metodo SerCxDeviceInitConfig viene chiamato dal driver del controller seriale per collegare l'estensione del framework seriale (SerCx) alla pipeline di I/O per un oggetto dispositivo framework (FDO o PDO) che sta creando.

Sintassi

NTSTATUS SerCxDeviceInitConfig(
  [in, out] PWDFDEVICE_INIT DeviceInit
);

Parametri

[in, out] DeviceInit

Puntatore alla struttura WDFDEVICE_INIT da configurare.

Valore restituito

SerCxDeviceInitConfig restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I possibili valori restituiti dall'errore includono il codice di stato seguente.

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	Impossibile allocare risorse di sistema (in genere memoria).

Osservazioni

Questo metodo associa le informazioni di configurazione di SerCx alla struttura WDFDEVICE_INIT per l'oggetto dispositivo framework (PDO o FDO) che deve essere creato. Chiamare SerCxDeviceInitConfig prima di chiamare il metodo WdfDeviceCreate per creare l'oggetto dispositivo.

Il driver del controller EvtDriverDeviceAdd funzione di callback riceve un puntatore a una struttura WDFDEVICE_INIT inizializzata come parametro di input.

SerCx imposta un descrittore di sicurezza predefinito che il driver del controller seriale può, se necessario, eseguire l'override. Ad esempio, questo descrittore di sicurezza predefinito consente a un driver in modalità utente di inviare una richiesta di I/O a un dispositivo periferico connesso a una porta nel controller seriale. Per modificare questa impostazione nel descrittore di sicurezza, il driver del controller seriale può chiamare il metodo WdfDeviceInitAssignSDDLString. Questa chiamata deve verificarsi dopo la chiamata SerCxDeviceInitConfig , ma prima della chiamata al metodo WdfDeviceCreate.

Esempi

Nell'esempio di codice seguente, la evtDriverDeviceAdd funzione di callback di un driver controller passa una struttura di WDFDEVICE_INIT inizializzata al metodo SerCxDeviceInitConfig. La chiamata a SerCxDeviceInitConfig deve verificarsi prima della chiamata WdfDeviceCreate che crea l'fdO per il dispositivo controller seriale (UART).

//
// FxDeviceInit is a pointer to an initialized WDFDEVICE_INIT structure.
// Drivers receive a pointer to this structure as an input parameter to an
// EvtDriverDeviceAdd callback function, or as a return value from the
// WdfControlDeviceInitAllocate method.
//

status = SerCxDeviceInitConfig(FxDeviceInit);

if (!NT_SUCCESS(status))
{
    return status;
}

// 
// Set WDF and SerCx device-level configuration options.
//

...

//
// Call the WdfDeviceCreate method.
//

...