Поделиться через

AVC_FUNCTION_GET_CONNECTINFO

  • Статья

Код функции AVC_FUNCTION_GET_CONNECT_INFO получает структуру AVCPRECONNECTINFO для каждого идентификатора закрепления (смещение от нуля).

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

В случае успешного выполнения драйвер протокола AV/C устанавливает для Irp-IoStatus.Status> значение STATUS_SUCCESS.

Возможные другие возвращаемые значения:

Возвращаемое значение Описание
STATUS_TIMEOUT Запрос был сделан, но ответ не получен до завершения обработки времени ожидания и повторных попыток.
STATUS_REQUEST_ABORTED Немедленно прервусь, когда состояние завершения IRP STATUS_REQUEST_ABORTED. Это означает, что устройство было удалено или больше не доступно на шине 1394.
СТАТУС_* Любой другой код возврата указывает, что произошла ошибка или предупреждение, которые не были область протокола AV/C.

Комментарии

Эта функция использует элемент PreConnectInfo структуры AVC_MULTIFUNC_IRB, как показано ниже.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PRECONNECT_INFO PreConnectInfo;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

Ниже приведены элементы структуры AVC_PRECONNECT_INFO.

typedef struct _AVC_PRECONNECT_INFO {
    IN ULONG PinId
    OUT AVCPRECONNECTINFO ConnectInfo;
} AVC_PRECONNECT_INFO, *PAVC_PRECONNECT_INFO;

Требования

Заголовки: Объявлено в avc.h. Включите avc.h.

Ввод AVC_MULTIFUNC_IRB

Common
Вложенная функция этого элемента должна иметь значение AVC_FUNCTION_GET_CONNECTINFO из перечисления AVC_FUNCTION.

ConnectInfo
Указывает сведения о подключении для устройства AV/C.

Этот код функции не поддерживается виртуальными экземплярами avc.sys.

Драйвер подсоединения должен использовать эту функцию, если он отвечает за создание диапазонов данных, включенных в структуру KSPIN_DESCRIPTOR. Структура AVCPRECONNECTINFO добавляется к элементу DataRanges для внешних подключений к компьютеру.

Он должен вызываться по адресу IRQL = PASSIVE_LEVEL.

См. также раздел

AVC_MULTIFUNC_IRB

AVC_PRECONNECT_INFO

AVCPRECONNECTINFO

AVC_FUNCTION