enumeración SPB_REQUEST_SEQUENCE_POSITION (spbcx.h)

La enumeración SPB_REQUEST_SEQUENCE_POSITION indica la posición de una solicitud de E/S en la lista de transferencias de una secuencia de transferencia de E/S.

Syntax

typedef enum _SPB_REQUEST_SEQUENCE_POSITION {
  SpbRequestSequencePositionInvalid,
  SpbRequestSequencePositionSingle,
  SpbRequestSequencePositionFirst,
  SpbRequestSequencePositionContinue,
  SpbRequestSequencePositionLast,
  SpbRequestSequencePositionMax
} SPB_REQUEST_SEQUENCE_POSITION, *PSPB_REQUEST_SEQUENCE_POSITION;

Constantes

Comentarios

Un cliente (controlador periférico) del controlador SPB puede realizar una secuencia de transferencia de E/S enviando una serie de solicitudes de lectura y escritura a un dispositivo de destino en el bus. Cada solicitud de lectura o escritura de la serie ocupa una posición en la lista de transferencias de la secuencia. Los valores de la enumeración SPB_REQUEST_SEQUENCE_POSITION indican las posiciones relativas de las solicitudes de lectura y escritura en esta lista.

El método SpbRequestGetParameters recupera los valores de parámetro específicos de SPB de una solicitud de E/S y los escribe en una estructura de SPB_REQUEST_PARAMETERS . Incluido en estos parámetros es un valor de enumeración SPB_REQUEST_SEQUENCE_POSITION que indica la posición de la solicitud de E/S en la secuencia de transferencia de E/S de la que forma parte.

Si se llama a SpbRequestGetParameters para recuperar el valor de posición de una solicitud de E/S que no forma parte de una secuencia, este método asigna un valor de enumeración de SPB_REQUEST_SEQUENCE_POSITION adecuado a la solicitud.

Para las solicitudes de lectura y escritura, el valor de posición se establece en uno de los siguientes valores: SpbRequestSequencePositionSingle, SpbRequestSequencePositionFirst, SpbRequestSequencePositionContinue o SpbRequestSequencePositionLast.

Si el cliente envía una solicitud simple de lectura o escritura (IRP_MJ_READ o IRP_MJ_WRITE) que no forma parte de una secuencia, el valor de posición se establece en SpbRequestSequencePositionSingle.

Si el cliente envía una solicitud de bloqueo (IOCTL_SPB_LOCK_CONTROLLER) para indicar el inicio de una secuencia, el valor de posición de la primera transferencia (solicitud de lectura o escritura) en la secuencia es SpbRequestSequencePositionFirst y el valor de posición de las transferencias restantes en la secuencia es SpbRequestSequencePositionContinue. En este caso, SpbCx no puede asignar SpbRequestSequencePositionLast a la última transferencia porque no sabe que el cliente ha enviado la última solicitud de lectura o escritura hasta que el cliente envíe la solicitud de desbloqueo (IOCTL_SPB_UNLOCK_CONTROLLER) que finaliza la secuencia.

Para las solicitudes de bloqueo, el valor de posición se establece en SpbRequestSequencePositionFirst. Para las solicitudes de desbloqueo, el valor de posición se establece en SpbRequestSequencePositionLast.

Algunos controladores pueden admitir operaciones especiales, como transferencias de bus dúplex completas que leen y escriben simultáneamente en un dispositivo de destino. Un cliente puede realizar una operación de secuencia personalizada bloqueando el controlador y enviando una serie de solicitudes de E/S personalizadas, que SpbCx pasa a la función de devolución de llamada EvtSpbControllerIoOther del controlador spB. En este caso, el valor de posición de la primera solicitud de E/S personalizada en la secuencia es SpbRequestSequencePositionFirst y el valor de posición de las solicitudes de E/S personalizadas restantes en la secuencia es SpbRequestSequencePositionContinue. La secuencia finaliza cuando el cliente desbloquea el controlador. Si la función de devolución de llamada EvtSpbControllerIoOther recibe una solicitud de E/S personalizada que no forma parte de una secuencia, el valor de posición de esta solicitud es SpbRequestSequencePositionSingle.

Para un valor de posición de SpbRequestSequencePositionLast, el miembro Length de la estructura de SPB_REQUEST_PARAMETERS puede ser 0 para indicar que el destino debe liberarse simplemente y que no se deben transferir datos de E/S (o, de forma equivalente, para indicar que debe producirse una transferencia de 0 bytes, si el controlador no puede liberar el dispositivo sin ejecutar el reloj).

Para los valores de posición de SpbRequestSequencePositionContinue y SpbRequestSequencePositionLast, la dirección de transferencia podría haber cambiado de la transferencia anterior y el controlador del controlador SPB podría necesitar indicar este posible cambio de dirección en el bus (por ejemplo, un controlador I²C emite una nueva condición START). Para obtener más información sobre las direcciones de transferencia, consulte SPB_TRANSFER_DIRECTION.

Requisitos

Consulte también

• EvtSpbControllerIoSequence
• IOCTL_SPB_LOCK_CONTROLLER
• IOCTL_SPB_UNLOCK_CONTROLLER
• IRP_MJ_READ
• IRP_MJ_WRITE
• SPB_REQUEST_PARAMETERS
• SPB_TRANSFER_DIRECTION
• SpbRequestGetParameters