AVCSTRM_WRITE

Статья
06/15/2023

Код функции AVCSTRM_WRITE используется для отправки буфера данных для передачи в указанный поток.

Блок состояния ввода-вывода

В случае успеха avcstrm.sys присваивает Irp-IoStatus.Status> значение STATUS_SUCCESS.

Возможные возвращаемые значения ошибок:

Состояние ошибки	Описание
STATUS_DEVICE_REMOVED	Устройство, соответствующее операции AVCSTRM_READ , больше не существует.
STATUS_CANCELLED	Не удалось выполнить запрос.
STATUS_INVALID_PARAMETER	Параметр, указанный в IRP, является неправильным.
STATUS_INSUFFICIENT_RESOURCES	Недостаточно системных ресурсов для выполнения запроса.
STATUS_PENDING	Запрос получен, но требует дальнейшей обработки. Подпрограмма завершения ввода-вывода будет обрабатывать окончательный ответ.

Входные данные AVC_STREAM_REQUEST_BLOCK

SizeOfThisBlock, версия и функция
Используйте макрос INIT_AVCSTRM_HEADER для инициализации этих элементов. Передайте AVCSTRM_WRITE в аргументе Request макроса.

AVCStreamContext
Указывает контекст потока (дескриптор), возвращаемый предыдущим вызовом AVCSTRM_OPEN , который является целевым объектом для операции записи данных.

BufferStruct
Указывает буфер, из который должна получать данные операция записи.

Драйвер подсоединения должен сначала выделить IRP и структуру AVC_STREAM_REQUEST_BLOCK .

Затем он должен использовать макрос INIT_AVCSTRM_HEADER для инициализации структуры AVC_STREAM_REQUEST_BLOCK, передав AVCSTRM_READ в качестве аргумента Request в макрос.

Затем драйвер подсоединения задает член AVCStreamContext в контекст (дескриптор) потока, который является целевым объектом операции записи данных. Наконец, драйвер подсоединения задает член BufferStruct объединения CommandData , описывающий буфер, из который операция записи получает данные.

Чтобы отправить этот запрос, подсоединительная единица отправляет IRP_MJ_INTERNAL_DEVICE_CONTROL IRP с элементом IoControlCode из набора IRP , равным IOCTL_AVCSTRM_CLASS, а член Argument1 набора IRP — AVC_STREAM_REQUEST_BLOCK структуре, описывающей операцию записи.

Эта команда выполняется асинхронно. После его завершения вызывается подпрограмма завершения ввода-вывода, заданная в IRP.

Этот код функции должен вызываться по адресу IRQL = PASSIVE_LEVEL.

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;