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 |