Función SpbDeviceInitConfig (spbcx.h)

El método SpbDeviceInitConfig asocia la extensión de marco 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.

Observaciones

Este método asocia la información de configuración de SpbCx a la estructura WDFDEVICE_INIT del 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

Consulte también

EvtDriverDeviceAdd

WDFDEVICE_INIT

WdfDeviceCrear

WdfPdoInitAllocate