REQUEST_RECEIVE_PHY_PACKETS control code

The REQUEST_RECEIVE_PHY_PACKETS request receives 1394 PHY packets from the bus.

The relevant members of the IRB for this request are as follows:


typedef struct _IRB {
  ULONG FunctionNumber;
    .
    .
    .
  union {
    struct {
      ULONG                           Flags;
      PBUS_PHY_PACKET_NOTIFICATION    PhyPacketRoutine; 
      PVOID                           PhyPacketContext; 
    } ReceivePhyPackets;
    .
    .
    .
  } u;
} IRB;

Input Buffer

IRB Input

FunctionNumber

REQUEST_RECEIVE_PHY_PACKETS

u.ReceivePhyPackets.Flags

Specifies whether a callback should be registered or deactivated. Use REGISTER_PHY_PACKET_NOTIFICATION to register PhyPacketRoutine as the callback. Use DEREGISTER_PHY_PACKET_NOTIFICATION to deactivate any previously registered callbacks.

u.ReceivePhyPackets.PhyPacketRoutine

Points to the notification routine for received PHY packets. The following prototype illustrates the notification routine:

void PhyPacketRoutine(
    __in PVOID           Context,
    __in ULONG           GenerationCount,
    __in ULARGE_INTEGER  PhyPacket
);

TermDescription

Context

The argument that is specified in the u.ReceivePhyPackets.PhyPacketContext parameter when the REQUEST_RECEIVE_PHY_PACKET request is sent.

GenerationCount

The generation count of the bus for this PHY packet.

PhyPacket

The 64-bit PHY packet that is received from the 1394 bus.

 

u. ReceivePhyPackets.PhyPacketContext

Specifies the Context argument to be passed to the PhyPacketRoutine.

Output Buffer

None.

Status block

None.

Remarks

The PhyPacketRoutine is called at DISPATCH_LEVEL.

Requirements

Version

Available in Windows 7 and later versions.

Header

1394.h

See also

DeviceIoControl
REQUEST_SEND_PHY_PACKET
Device Driver Interface (DDI) Changes in Windows 7

 

 

Send comments about this topic to Microsoft

Show: