Compartir a través de


Función SpbDeviceInitialize (spbcx.h)

El método SpbDeviceInitialize completa la inicialización del controlador del controlador SPB después de que este controlador cree el objeto de dispositivo asociado.

Sintaxis

NTSTATUS SpbDeviceInitialize(
  [in] WDFDEVICE              FxDevice,
  [in] PSPB_CONTROLLER_CONFIG Config
);

Parámetros

[in] FxDevice

Un controlador WDFDEVICE para el objeto de dispositivo que representa el controlador SPB.

[in] Config

Puntero a una estructura de SPB_CONTROLLER_CONFIG que contiene la información de configuración del dispositivo para el controlador del controlador SPB. La función SPB_CONTROLLER_CONFIG_INIT debe inicializar esta estructura.

Valor devuelto

SpbDeviceInitialize devuelve STATUS_SUCCESS si se ejecuta correctamente. De lo contrario, devuelve un código de error NTSTATUS adecuado.

Comentarios

El controlador del controlador SPB llama a este método para registrar sus funciones de devolución de llamada de eventos con la extensión del marco de SPB (SpbCx) y especificar el modo de transferencia que se usará para la cola de E/S del controlador. SpbDeviceInitialize crea todas las estructuras de datos internas del controlador, incluida la cola de E/S.

El controlador del controlador SPB debe llamar a este método antes de confirmar el objeto de dispositivo, es decir, antes de que vuelva de la devolución de llamada EvtDriverDeviceAdd o agregue el PDO a la lista secundaria del controlador. La lista secundaria representa los dispositivos conectados al bus. Para obtener más información, vea Enumerar los dispositivos en un bus.

Después de que SpbDeviceInitialize devuelva, el controlador está listo para procesar solicitudes de E/S, pero el controlador del controlador SPB puede, según sea necesario, seguir configurando las opciones del controlador antes de confirmar el objeto de dispositivo.

Si la estructura a la que apunta Config no se rellena correctamente, el comprobador del controlador generará un error. Para obtener más información sobre los requisitos del parámetro Config , consulte SPB_CONTROLLER_CONFIG.

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

Consulte también

EvtChildListCreateDevice

EvtDriverDeviceAdd

SPB_CONTROLLER_CONFIG

SPB_CONTROLLER_CONFIG_INIT