AVCSTRM_READ

Artículo
06/15/2023

El código de función AVCSTRM_READ se usa para enviar un búfer de datos avcstrm.sys que se rellena con datos de la secuencia especificada.

Bloque de estado de entrada/salida

Si se ejecuta correctamente, avcstrm.sys establece Irp-IoStatus.Status> en STATUS_SUCCESS.

Entre los valores devueltos de error posibles se incluyen:

Estado del error	Descripción
STATUS_DEVICE_REMOVED	El dispositivo correspondiente a la operación de AVCSTRM_READ ya no existe.
STATUS_CANCELLED	No se pudo completar la solicitud.
STATUS_INVALID_PARAMETER	Un parámetro especificado en el IRP es incorrecto,
STATUS_INSUFFICIENT_RESOURCES	No había suficientes recursos del sistema para completar la solicitud.
STATUS_PENDING	La solicitud se ha recibido, pero requiere un procesamiento adicional. La rutina de finalización de E/S controlará la respuesta final.

entrada de AVC_STREAM_REQUEST_BLOCK

SizeOfThisBlock, Version y Function
Use la macro INIT_AVCSTRM_HEADER para inicializar estos miembros. Pase AVCSTRM_READ en el argumento Request de la macro.

AVCStreamContext
Especifica el contexto de flujo (identificador) devuelto por una llamada de AVCSTRM_OPEN anterior que es el origen de datos para la operación de lectura.

BufferStruct
Especifica el búfer en el que debe colocarse la operación de lectura los datos.

Un controlador de subbúsito primero debe asignar un IRP y una estructura de AVC_STREAM_REQUEST_BLOCK .

A continuación, debe usar la macro INIT_AVCSTRM_HEADER para inicializar la estructura de AVC_STREAM_REQUEST_BLOCK, pasando AVCSTRM_READ como argumento Request a la macro.

A continuación, el controlador de subbúsco establece el miembro AVCStreamContext en el contexto de secuencia (identificador) de la secuencia que proporciona los datos que se van a leer. Por último, el controlador de subbúfer establece el miembro BufferStruct de la unión CommandData que describe el búfer en el que la operación de lectura coloca los datos.

Para enviar esta solicitud, una subunidad envía un irP de IRP_MJ_INTERNAL_DEVICE_CONTROL con el miembro IoControlCode del IRP establecido en IOCTL_AVCSTRM_CLASS y el miembro Argument1 del IRP establecido en la estructura de AVC_STREAM_REQUEST_BLOCK que describe la operación de lectura que se va a realizar.

Este comando se completa de forma asincrónica. Cuando se completa, se llama a la rutina de finalización de E/S establecida en irP.

Se debe llamar a este código de función en IRQL = PASSIVE_LEVEL.

Comentarios

Esta función usa el miembro BufferStruct de la unión CommandData en la estructura AVC_STREAM_REQUEST_BLOCK como se muestra a continuación.

typedef struct _AVC_STREAM_REQUEST_BLOCK {
  ULONG  SizeOfThisBlock;
  ULONG  Version;
  AVCSTRM_FUNCTION  Function;
  .
  .
  PVOID AVCStreamContext;
  .
  .
  union _tagCommandData {
    .
    .
    AVCSTRM_BUFFER_STRUCT  BufferStruct;
    .
    .
  } CommandData;
} AVC_STREAM_REQUEST_BLOCK, *PAVC_STREAM_REQUEST_BLOCK;