estrutura GET_LOCAL_HOST_INFO2 (1394.h)

  • Artigo

A estrutura GET_LOCAL_HOST_INFO2 contém os dados retornados por uma solicitação de REQUEST_GET_LOCAL_HOST_INFO usando u.GetLocalHostInformation.nLevel GET_HOST_CAPABILITIES.

Sintaxe

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

Membros

HostCapabilities

Indica os recursos do host. A tabela a seguir lista os valores que podem ser atribuídos a th é membro:

Sinalizador Descrição
HOST_INFO_PACKET_BASED O controlador host dá suporte a transações isocronas baseadas em pacotes.
HOST_INFO_STREAM_BASED O controlador de host dá suporte a transações isocronas baseadas em fluxo.
HOST_INFO_SUPPORTS_ISOCH_STRIPPING O controlador host dá suporte à remoção configurável de informações de cabeçalho.
HOST_INFO_SUPPORTS_START_ON_CYCLE O controlador host dá suporte à sincronização do início em tempos de ciclo isócronos específicos.
HOST_INFO_SUPPORTS_RETURNING_ISO_HDR O controlador de host não remove automaticamente o cabeçalho de pacote isócrono.
HOST_INFO_SUPPORTS_ISO_HDR_INSERTION O controlador host dá suporte ao sinalizador de DESCRIPTOR_HEADER_SCATTER_GATHER em ISOCH_DESCRIPTOR.
HOST_INFO_SUPPORTS_ISO_DUAL_BUFFER_RX O controlador host dá suporte ao sinalizador de RESOURCE_VARIABLE_ISOCH_PAYLOAD em ISOCH_DESCRIPTOR.
HOST_INFO_DMA_DOUBLE_BUFFERING_ENABLED DMA as transferências feitas de/para o controlador host serão armazenadas em buffer duplo usando registros de mapa do sistema. Os registros de mapa do sistema limitam o tamanho de uma única transferência. Verifique o valor MaxDmaBufferSize retornado na estrutura GET_LOCAL_HOST_INFO7 por uma solicitação REQUEST_GET_LOCAL_HOST_INFO e limite o tamanho da transferência adequadamente.

MaxAsyncReadRequest

O driver de barramento preenche esse membro com a solicitação de leitura assíncrona de tamanho máximo compatível com o controlador de host.

MaxAsyncWriteRequest

O driver de barramento preenche esse membro com a solicitação de gravação assíncrona de tamanho máximo compatível com o controlador de host.

Comentários

Os drivers de porta que retornam o sinalizador HOST_INFO_PACKET_BASED dão suporte ao sinalizador de RESOURCE_USE_PACKET_BASED da solicitação IsochAllocateResources. Os drivers de porta que retornam o sinalizador HOST_STREAM_PACKET_BASED dão suporte à E/S baseada em fluxo. Se o controlador de host não der suporte à E/S baseada em fluxo, o driver deverá usar E/S baseada em pacote e definir o sinalizador RESOURCE_USE_PACKET_BASED ao emitir o REQUEST_ISOCH_ALLOCATE_RESOURCES.

Alguns controladores de host removem automaticamente o cabeçalho do pacote de um pacote isócrono. Se um controlador de host não remover automaticamente o cabeçalho, o driver de porta retornará o sinalizador HOST_INFO_SUPPORTS_ISO_HDR. Alguns controladores de host permitem que um driver configure o controlador de host para remover um determinado número de quadlets; para esses controladores, o driver de porta retorna o sinalizador HOST_INFO_SUPPORTS_ISOCH_STRIPPING. O driver deve marcar esse sinalizador antes de chamar REQUEST_ISOCH_ALLOCATE_RESOURCES com o sinalizador RESOURCE_STRIP_ADDITIONAL_QUADLETS.

Se um controlador de host der suporte à sincronização de solicitações de REQUEST_ISOCH_LISTEN e REQUEST_ISOCH_TALK para o tempo de ciclo isócrono, o driver de porta retornará o HOST_INFO_SUPPORTS_START_ON_CYCLE. Os drivers devem marcar esse sinalizador antes de tentar emitir uma solicitação de REQUEST_ISOCH_ALLOCATE_RESOURCES usando o sinalizador RESOURCE_SYNCH_ON_TIME ou antes de anexar um buffer cujo ISOCH_DESCRIPTOR tem o sinalizador DESCRIPTOR_SYNCH_ON_TIME definido.

Requisitos

Requisito Valor
Cabeçalho 1394.h (inclua 1394.h)

Confira também

GET_LOCAL_HOST_INFO7

ISOCH_DESCRIPTOR

REQUEST_GET_LOCAL_HOST_INFO

REQUEST_ISOCH_ALLOCATE_RESOURCES