Funzione SerCx2InitializeDeviceInit (sercx.h)

Articolo
08/07/2023

Il metodo SerCx2InitializeDeviceInit consente alla versione 2 dell'estensione del framework seriale (SerCx2) di registrare proprietà specifiche dell'estensione con il framework driver durante la creazione dell'oggetto dispositivo framework per il controller seriale.

Sintassi

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

Parametri

[in, out] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT , ovvero una struttura opaca che archivia le informazioni usate da Kernel Mode Driver Framework (KMDF) per creare un oggetto dispositivo framework. Il driver del controller seriale riceve un puntatore a questa struttura come parametro di input per la funzione evtDriverDeviceAggiungi callback del driver.

Valore restituito

SerCx2InitializeDeviceInit restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti degli errori possibili includono i codici di stato seguenti.

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	Il metodo è stato chiamato in IRQL errato o il parametro DeviceInit è NULL.
STATUS_INSUFFICIENT_RESOURCES	Sono disponibili risorse insufficienti per eseguire l'operazione richiesta.

Commenti

Il driver del controller seriale deve chiamare questo metodo dalla relativa funzione evtDriverDeviceAdd callback prima di creare un oggetto WDFDEVICE per il controller seriale.

SerCx2InitializeDeviceInit collega informazioni specifiche dell'estensione alla struttura WDFDEVICE_INIT del driver. Queste informazioni consentono a SerCx2 di eseguire determinate azioni per conto del driver del controller seriale. SerCx2, ad esempio, riceve richieste di I/O inviate ai client al controller seriale.

Il driver del controller seriale deve chiamare SerCx2InitializeDeviceInit prima di creare un oggetto dispositivo framework per rappresentare il controller seriale e prima di chiamare il metodo SerCx2InitializeDevice per completare l'inizializzazione dell'oggetto dispositivo. Il driver chiama un metodo come WdfDeviceCreate per creare l'oggetto dispositivo.

SerCx2InitializeDeviceInit imposta un descrittore di sicurezza predefinito che consente sia i driver in modalità kernel che i driver in modalità utente di inviare richieste di I/O a SerCx2. Il descrittore consente alle applicazioni di inviare queste richieste solo se vengono eseguiti con privilegi di amministratore. Per specificare questo descrittore, SerCx2 usa la stringa SDDL seguente:

"D:P(A;;GA;;;SY)(A;;GA;;;BA)(A;;GA;;;UD)" Se necessario, il driver del controller seriale può eseguire l'override dell'impostazione predefinita chiamando il metodo WdfDeviceInitAssignSDDLString con il descrittore di sicurezza desiderato. Il driver deve chiamare WdfDeviceInitAssignSDDLString dopo aver chiamato SerCx2InitializeDeviceInit , ma prima di chiamare WdfDeviceCreate. Per altre informazioni sulle stringhe SDDL, vedere SDDL per oggetti dispositivo.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.1.
Piattaforma di destinazione	Universale
Intestazione	sercx.h
IRQL	PASSIVE_LEVEL

Vedi anche

EvtDriverDeviceAdd

SerCx2InitializeDevice

WDFDEVICE_INIT

WdfDeviceCreate

WdfDeviceInitAssignSDDLString