Función SpbDeviceInitConfig (spbcx.h)
El método SpbDeviceInitConfig asocia la extensión de marco de SPB (SpbCx) a la cadena de solicitudes de E/S para un objeto WDFDEVICE (FDO o PDO) que se va a crear.
Sintaxis
NTSTATUS SpbDeviceInitConfig(
[in, out] WDFDEVICE_INIT *DeviceInit
);
Parámetros
[in, out] DeviceInit
Puntero a la estructura WDFDEVICE_INIT que se va a configurar.
Valor devuelto
SpbDeviceInitConfig devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Los valores devueltos posibles incluyen el siguiente código de error.
| Código devuelto | Descripción |
|---|---|
|
No se pueden asignar los recursos del sistema necesarios. |
Comentarios
Este método asocia la información de configuración de SpbCx con la estructura de WDFDEVICE_INIT para el objeto de dispositivo (PDO o FDO) que se va a crear. La rutina de devolución de llamada EvtDriverDeviceAdd del controlador debe llamar a SpbDeviceInitConfig antes de llamar al método WdfDeviceCreate para crear el objeto de dispositivo.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el método SpbDeviceInitConfig para asociar la información de configuración de la extensión de marco spbCx con la estructura WDFDEVICE_INIT .
//
// FxDeviceInit is a pointer to a WDFDEVICE_INIT structure that comes as a
// parameter for an EvtDriverDeviceAdd handler, or from WdfPdoInitAllocate.
//
status = SpbDeviceInitConfig(FxDeviceInit);
if (!NT_SUCCESS(status))
{
return status;
}
//
// Set WDF and SpbCx device-level configuration options.
//
...
//
// Call WdfDeviceCreate
//
status = WdfDeviceCreate(&FxDeviceInit,...);
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 8. |
| Plataforma de destino | Universal |
| Encabezado | spbcx.h |
| Library | Spbcxstubs.lib |
| IRQL | PASSIVE_LEVEL |