Estrutura IRB (1394.h)

Os motoristas usam essa estrutura para passar a maioria das solicitações ao motorista de ônibus do IEEE 1394.

Sintaxe

typedef struct _IRB {
  ULONG     FunctionNumber;
  ULONG     Flags;
  ULONG_PTR BusReserved[IRB_BUS_RESERVED_SZ];
  ULONG_PTR PortReserved[IRB_PORT_RESERVED_SZ];
  union {
    IRB_REQ_ASYNC_READ                          AsyncRead;
    IRB_REQ_ASYNC_WRITE                         AsyncWrite;
    IRB_REQ_ASYNC_LOCK                          AsyncLock;
    IRB_REQ_ISOCH_ALLOCATE_BANDWIDTH            IsochAllocateBandwidth;
    IRB_REQ_ISOCH_ALLOCATE_CHANNEL              IsochAllocateChannel;
    IRB_REQ_ISOCH_ALLOCATE_RESOURCES            IsochAllocateResources;
    IRB_REQ_ISOCH_ATTACH_BUFFERS                IsochAttachBuffers;
    IRB_REQ_ISOCH_DETACH_BUFFERS                IsochDetachBuffers;
    IRB_REQ_ISOCH_FREE_BANDWIDTH                IsochFreeBandwidth;
    IRB_REQ_ISOCH_FREE_CHANNEL                  IsochFreeChannel;
    IRB_REQ_ISOCH_FREE_RESOURCES                IsochFreeResources;
    IRB_REQ_ISOCH_LISTEN                        IsochListen;
    IRB_REQ_ISOCH_QUERY_CURRENT_CYCLE_TIME      IsochQueryCurrentCycleTime;
    IRB_REQ_ISOCH_QUERY_RESOURCES               IsochQueryResources;
    IRB_REQ_ISOCH_SET_CHANNEL_BANDWIDTH         IsochSetChannelBandwidth;
    IRB_REQ_ISOCH_STOP                          IsochStop;
    IRB_REQ_ISOCH_TALK                          IsochTalk;
    IRB_REQ_ISOCH_MODIFY_STREAM_PROPERTIES      IsochModifyStreamProperties;
    IRB_REQ_ALLOCATE_ADDRESS_RANGE              AllocateAddressRange;
    IRB_REQ_FREE_ADDRESS_RANGE                  FreeAddressRange;
    IRB_REQ_GET_LOCAL_HOST_INFORMATION          GetLocalHostInformation;
    IRB_REQ_GET_1394_ADDRESS_FROM_DEVICE_OBJECT Get1394AddressFromDeviceObject;
    IRB_REQ_CONTROL                             Control;
    IRB_REQ_GET_MAX_SPEED_BETWEEN_DEVICES       GetMaxSpeedBetweenDevices;
    IRB_REQ_SET_DEVICE_XMIT_PROPERTIES          SetDeviceXmitProperties;
    IRB_REQ_SET_LOCAL_HOST_PROPERTIES           SetLocalHostProperties;
    IRB_REQ_GET_CONFIGURATION_INFORMATION       GetConfigurationInformation;
    IRB_REQ_GET_CONFIG_ROM                      GetConfigRom;
    IRB_REQ_BUS_RESET                           BusReset;
    IRB_REQ_GET_GENERATION_COUNT                GetGenerationCount;
    IRB_REQ_SEND_PHY_CONFIGURATION_PACKET       SendPhyConfigurationPacket;
    IRB_REQ_SEND_PHY_PACKET                     SendPhyPacket;
    IRB_REQ_RECEIVE_PHY_PACKETS                 ReceivePhyPackets;
    IRB_REQ_GET_SPEED_TOPOLOGY_MAPS             GetSpeedTopologyMaps;
    IRB_REQ_BUS_RESET_NOTIFICATION              BusResetNotification;
    IRB_REQ_ASYNC_STREAM                        AsyncStream;
  } u;
} IRB, *PIRB;

Membros

FunctionNumber

Determina o tipo de solicitação. Cada tipo de solicitação é documentado sob o valor de FunctionNumber em Solicitações de E/S de Barramento IEEE 1394.

Flags

Reservado. Os drivers devem definir esse membro como zero com uma exceção. Ao fazer uma solicitação de REQUEST_ISOCH_ALLOCATE_BANDWIDTH , o chamador pode definir o sinalizador IRB_FLAG_ALLOW_REMOTE_FREE em Flags para indicar que o sistema deve liberar a memória do identificador de largura de banda apontada como IsochAllocateBandwidth.hBandwidth. Se o chamador não definir esse sinalizador, o chamador terá que liberar o identificador de largura de banda.

BusReserved[IRB_BUS_RESERVED_SZ]

Reservado.

PortReserved[IRB_PORT_RESERVED_SZ]

Reservado.

u

Especifica uma união de estruturas, uma para cada valor de FunctionNumber. Os submembros aplicáveis de u para cada solicitação são descritos com cada tipo de solicitação em Solicitações de E/S de Barramento IEEE 1394.

FunctionNumber	Membro associado
REQUEST_ALLOCATE_ADDRESS_RANGE	AllocateAddressRange
REQUEST_ASYNC_LOCK	AsyncLock
REQUEST_ASYNC_READ	AsyncRead
REQUEST_ASYNC_STREAM	AsyncStream
REQUEST_ASYNC_WRITE	AsyncWrite
REQUEST_ISOCH_ALLOCATE_BANDWIDTH	IsochAllocateBandwidth
REQUEST_ISOCH_DETACH_BUFFERS	IsochDetachBuffers
REQUEST_ISOCH_LISTEN	IsochListen
REQUEST_ISOCH_MODIFY_STREAM_PROPERTIES	IsochModifyStreamProperties
REQUEST_ISOCH_QUERY_RESOURCES	IsochQueryResources
REQUEST_ISOCH_SET_CHANNEL_BANDWIDTH	IsochSetChannelBandwidth
REQUEST_FREE_ADDRESS_RANGE	FreeAddressRange
REQUEST_GET_CONFIG_ROM	GetConfigRom
REQUEST_GET_LOCAL_HOST_INFO	GetLocalHostInformation
REQUEST_GET_SPEED_BETWEEN_DEVICES	GetMaxSpeedBetweenDevices
REQUEST_GET_SPEED_TOPOLOGY_MAPS	GetSpeedTopologyMaps
REQUEST_SEND_PHY_CONFIG_PACKET	SendPhyConfigurationPacket
REQUEST_SEND_PHY_PACKET	SendPhyPacket
REQUEST_SET_LOCAL_HOST_PROPERTIES	SetLocalHostProperties
REQUEST_SET_DEVICE_XMIT_PROPERTIES	SetDeviceXmitProperties
REQUEST_RECEIVE_PHY_PACKET	ReceivePhyPackets

u.AsyncRead

u.AsyncWrite

u.AsyncLock

u.IsochAllocateBandwidth

u.IsochAllocateChannel

u.IsochAllocateResources

u.IsochAttachBuffers

u.IsochDetachBuffers

u.IsochFreeBandwidth

u.IsochFreeChannel

u.IsochFreeResources

u.IsochListen

u.IsochQueryCurrentCycleTime

u.IsochQueryResources

u.IsochSetChannelBandwidth

u.IsochStop

u.IsochTalk

u.IsochModifyStreamProperties

u.AllocateAddressRange

u.FreeAddressRange

u.GetLocalHostInformation

u.Get1394AddressFromDeviceObject

u.Control

u.GetMaxSpeedBetweenDevices

u.SetDeviceXmitProperties

u.SetLocalHostProperties

u.GetConfigurationInformation

u.GetConfigRom

u.BusReset

u.GetGenerationCount

u.SendPhyConfigurationPacket

u.SendPhyPacket

u.ReceivePhyPackets

u.GetSpeedTopologyMaps

u.BusResetNotification

u.AsyncStream

Comentários

O membro Parameters-Others.Arguments1> de um IRP IOCTL_1394_CLASS aponta para uma estrutura IRB. O motorista do ônibus usa o IRB para determinar o tipo de solicitação feita pelo driver do dispositivo e também para retornar os resultados da operação. Consulte Solicitações de E/S de Barramento IEEE 1394 para obter uma descrição do comportamento de cada solicitação.

Requisitos

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

Confira também

IOCTL_1394_CLASS