estructura GET_LOCAL_HOST_INFO2 (1394.h)

Artículo
03/08/2023

La estructura de GET_LOCAL_HOST_INFO2 contiene los datos devueltos por una solicitud de REQUEST_GET_LOCAL_HOST_INFO mediante u.GetLocalHostInformation.nLevel GET_HOST_CAPABILITIES.

Sintaxis

typedef struct _GET_LOCAL_HOST_INFO2 {
  ULONG HostCapabilities;
  ULONG MaxAsyncReadRequest;
  ULONG MaxAsyncWriteRequest;
} GET_LOCAL_HOST_INFO2, *PGET_LOCAL_HOST_INFO2;

Miembros

HostCapabilities

Indica las funcionalidades del host. En la tabla siguiente se enumeran los valores que se pueden asignar a th es miembro:

Marca	Descripción
HOST_INFO_PACKET_BASED	El controlador de host admite transacciones isócrónicas basadas en paquetes.
HOST_INFO_STREAM_BASED	El controlador de host admite transacciones isócrónicas basadas en secuencias.
HOST_INFO_SUPPORTS_ISOCH_STRIPPING	El controlador de host admite la eliminación configurable de información de encabezado.
HOST_INFO_SUPPORTS_START_ON_CYCLE	El controlador host admite el inicio de sincronización en tiempos de ciclo isócronos específicos.
HOST_INFO_SUPPORTS_RETURNING_ISO_HDR	El controlador de host no quita automáticamente el encabezado de paquete isócrono.
HOST_INFO_SUPPORTS_ISO_HDR_INSERTION	El controlador de host admite la marca DESCRIPTOR_HEADER_SCATTER_GATHER en ISOCH_DESCRIPTOR.
HOST_INFO_SUPPORTS_ISO_DUAL_BUFFER_RX	El controlador de host admite la marca RESOURCE_VARIABLE_ISOCH_PAYLOAD en ISOCH_DESCRIPTOR.
HOST_INFO_DMA_DOUBLE_BUFFERING_ENABLED DMA	Las transferencias realizadas hacia y desde el controlador de host se almacenarán en búfer doble mediante registros de mapa del sistema. Los registros de mapa del sistema limitan el tamaño de una sola transferencia. Compruebe el valor MaxDmaBufferSize devuelto en la estructura GET_LOCAL_HOST_INFO7 por una solicitud de REQUEST_GET_LOCAL_HOST_INFO y limite el tamaño de transferencia en consecuencia.

MaxAsyncReadRequest

El controlador de bus rellena este miembro con la solicitud de lectura asincrónica de tamaño máximo que admite el controlador de host.

MaxAsyncWriteRequest

El controlador de bus rellena este miembro con la solicitud de escritura asincrónica de tamaño máximo que admite el controlador de host.

Comentarios

Los controladores de puerto que devuelven la marca HOST_INFO_PACKET_BASED admiten la marca de RESOURCE_USE_PACKET_BASED de la solicitud IsochAllocateResources. Los controladores de puerto que devuelven la marca HOST_STREAM_PACKET_BASED admiten E/S basada en secuencias. Si el controlador de host no admite E/S basada en secuencias, el controlador debe usar E/S basada en paquetes y establecer la marca RESOURCE_USE_PACKET_BASED al emitir el REQUEST_ISOCH_ALLOCATE_RESOURCES.

Algunos controladores host quitan automáticamente el encabezado del paquete de un paquete isócrono. Si un controlador de host no quita automáticamente el encabezado, el controlador de puerto devuelve la marca HOST_INFO_SUPPORTS_ISO_HDR. Algunos controladores host permiten a un controlador configurar el controlador de host para quitar un número determinado de quadlets; para estos controladores, el controlador de puerto devuelve la marca HOST_INFO_SUPPORTS_ISOCH_STRIPPING. El controlador debe comprobar esta marca antes de llamar a REQUEST_ISOCH_ALLOCATE_RESOURCES con la marca RESOURCE_STRIP_ADDITIONAL_QUADLETS.

Si un controlador de host admite la sincronización de REQUEST_ISOCH_LISTEN y REQUEST_ISOCH_TALK solicitudes al tiempo de ciclo isócrono, el controlador de puerto devuelve el HOST_INFO_SUPPORTS_START_ON_CYCLE. Los controladores deben comprobar esta marca antes de intentar emitir una solicitud de REQUEST_ISOCH_ALLOCATE_RESOURCES mediante la marca RESOURCE_SYNCH_ON_TIME o antes de adjuntar un búfer cuya ISOCH_DESCRIPTOR tenga establecida la marca DESCRIPTOR_SYNCH_ON_TIME.