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;

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.

Operation

The PhyPacketRoutine is called at DISPATCH_LEVEL.

Requirements

Version

Available in Windows 7 and later versions.

Header

Winioctl.h

See also

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

 

 

Send comments about this topic to Microsoft

Show: