EVT_SPB_CONTROLLER_WRITE función de devolución de llamada (spbcx.h)
La función de devolución de llamada de eventos EvtSpbControllerIoWrite del controlador SPB escribe datos en el dispositivo de destino especificado de los búferes que se proporcionan con la solicitud de escritura.
Sintaxis
EVT_SPB_CONTROLLER_WRITE EvtSpbControllerWrite;
void EvtSpbControllerWrite(
[in] WDFDEVICE Controller,
[in] SPBTARGET Target,
[in] SPBREQUEST Request,
[in] size_t Length
)
{...}
Parámetros
[in] Controller
Un controlador WDFDEVICE para el objeto de dispositivo de marco que representa el controlador SPB.
[in] Target
Identificador SPBTARGET para el destino de esta solicitud de E/S. El destino es un dispositivo periférico o puerto que está conectado al bus. La extensión del marco spB (SpbCx) asignó previamente este identificador al destino en la devolución de llamada EvtSpbTargetConnect que abrió la conexión al destino.
[in] Request
Un identificador SPBREQUEST para la solicitud de E/S. El controlador del controlador SPB debe completar esta solicitud realizando la operación solicitada o devolviendo un estado de error. Para obtener más información, vea Comentarios.
[in] Length
Número de bytes que se van a escribir en el dispositivo de destino.
Valor devuelto
None
Observaciones
SpbCx administra la cola de E/S para el controlador SPB. SpbCx llama a la función de devolución de llamada EvtSpbControllerIoWrite del controlador SPB cuando un cliente (controlador periférico) del controlador SPB envía una solicitud de IRP_MJ_WRITE a un dispositivo de destino conectado al bus. El valor del parámetro Request es un identificador que encapsula esta solicitud.
Una devolución de llamada EvtSpbControllerIoWrite no devuelve un valor de estado. En su lugar, el controlador del controlador SPB indica el estado de la operación de escritura en el estado de finalización de la solicitud de E/S.
Una devolución de llamada EvtSpbControllerIoWrite es asincrónica. Es decir, la función de devolución de llamada debe iniciar la operación de escritura solicitada y, a continuación, volver sin esperar a que se complete la operación. Más adelante, el controlador del controlador SPB completa la solicitud de escritura durante una interrupción DPC o un DPC del temporizador.
Una devolución de llamada EvtSpbControllerIoWrite no devuelve un valor de estado. En su lugar, el controlador del controlador SPB indica el estado de la operación de escritura en el estado de finalización de la solicitud de E/S.
Si la operación de escritura se completa en su totalidad, la función de devolución de llamada debe establecer el estado de finalización en STATUS_SUCCESS. Si el dispositivo de destino indica que no puede aceptar más datos antes de que se complete una transmisión, el controlador debe establecer el estado de finalización en STATUS_SUCCESS y especificar el número de bytes transmitidos.
Si se produce un error de transmisión durante la operación de escritura, el controlador debe establecer el estado de finalización en la solicitud de E/S en un código de error adecuado. No todos los autobuses proporcionan un mecanismo para que un dispositivo de destino notifique un error de transporte o una transferencia completada parcialmente, y no todos los controladores pueden detectar estas condiciones.
Para registrar una función de devolución de llamada EvtSpbControllerIoWrite , llame al método SpbDeviceInitialize .
Ejemplos
Para definir una función de devolución de llamada EvtSpbControllerIoWrite , primero debe proporcionar una declaración de función que identifique el tipo de función de devolución de llamada que está definiendo. Windows proporciona un conjunto de tipos de función de devolución de llamada para controladores. Declarar una función mediante los tipos de función de devolución de llamada ayuda a Análisis de código para controladores, Comprobador de controladores estáticos (SDV) y otras herramientas de comprobación encuentran errores y es un requisito para escribir controladores para el sistema operativo Windows.
Por ejemplo, para definir una función de devolución de llamada EvtSpbControllerIoWrite denominada MyEvtSpbControllerIoWrite, use el tipo de función EVT_SPB_CONTROLLER_WRITE, como se muestra en este ejemplo de código:
EVT_SPB_CONTROLLER_WRITE MyEvtSpbControllerIoWrite;
A continuación, implemente la función de devolución de llamada de la siguiente manera:
_Use_decl_annotations_
VOID
MyEvtSpbControllerIoWrite(
WDFDEVICE Controller,
SPBTARGET Target,
SPBREQUEST Request,
size_t Length
)
{ ... }
El tipo de función EVT_SPB_CONTROLLER_WRITE se define en el archivo de encabezado Spbcx.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función EVT_SPB_CONTROLLER_WRITE del archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante tipos de rol de función para controladores KMDF. Para obtener más información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 8. |
| Plataforma de destino | Escritorio |
| Encabezado | spbcx.h |
| IRQL | Se llama en IRQL <= DISPATCH_LEVEL. |