Hardware Dev Center

IRB structure

Drivers use this structure to pass most requests to IEEE 1394 bus driver.

Syntax


typedef struct _IRB {
  ULONG     FunctionNumber;
  ULONG     Flags;
  ULONG_PTR BusReserved[IRB_BUS_RESERVED_SZ];
  ULONG_PTR PortReserved[IRB_PORT_RESERVED_SZ];
  union  u;
} IRB, *PIRB;

Members

FunctionNumber

Determines the type of request. Each request type is documented under the value of FunctionNumber in IEEE 1394 Bus I/O Requests.

Flags

Reserved. Drivers must set this member to zero with one exception. When making a REQUEST_ISOCH_ALLOCATE_BANDWIDTH request, the caller can set the IRB_FLAG_ALLOW_REMOTE_FREE flag in Flags to indicate that the system should free the bandwidth handle memory pointed to be IsochAllocateBandwidth.hBandwidth. If caller does not set this flag, then caller will have to free the bandwidth handle.

BusReserved

Reserved.

PortReserved

Reserved.

u

Specifies a union of structures, one for each value of FunctionNumber. The applicable submembers of u for each request are described with each request type in IEEE 1394 Bus I/O Requests.

FunctionNumberAssociated Member
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

 

Remarks

The Parameters->Others.Arguments1 member of an IOCTL_1394_CLASS IRP points to an IRB structure. The bus driver uses the IRB to determine the type of request made by the device driver, and also to return the results of the operation. See IEEE 1394 Bus I/O Requests for a description of the behavior of each request.

Requirements

Header

1394.h (include 1394.h)

See also

IOCTL_1394_CLASS

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft