AVCSTRM_SET_STATE

Статья
06/15/2023

Код функции AVCSTRM_SET_STATE помещает указанный поток в новое состояние потока.

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

В случае успешного выполнения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_SET_STATE в аргументе Request макроса.

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

StreamState
Указывает новое состояние потока, в которое будет помещать поток.

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

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

Затем драйвер подсоединения задает член AVCStreamContext в контекст (дескриптор) потока для получения состояния потока.

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

Драйвер подсоединия может ожидать, что эта команда будет выполнена синхронно. Результат возвращается немедленно без ожидающей операции в avcstrm.sys.

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

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