BUS_RESET_NOTIFY structure (61883.h)

This structure is used to register or deregister the PBUS_RESET_ROUTINE callback. The request registers the caller to be notified when a reset of the 1394 bus occurs or cancels a previous registration. When the registered callback (bus reset) routine is called, the updated generation count and node address will be specified in parameter BusResetInfo. If a driver registers for bus-reset notification, it must cancel registration before the system unloads the driver.

Syntax

typedef struct _BUS_RESET_NOTIFY {
  IN ULONG              Flags;
  IN PBUS_RESET_ROUTINE pfnNotify;
  IN PVOID              Context;
} BUS_RESET_NOTIFY, *PBUS_RESET_NOTIFY;

Members

Flags

The caller sets this member to REGISTER_BUS_RESET_NOTIFY to register to receive bus-reset notifications, or to DEREGISTER_BUS_RESET_NOTIFY to stop receiving bus-reset notifications.

pfnNotify

Pointer to a caller-supplied function to be called by the protocol driver when the 1394 bus is reset.

This function uses the following prototype:

Void
  (*PBUS_RESET_ROUTINE)( 
 IN PVOID  Context; 
 IN PBUS_GENERATION_NODE  BusResetInfo;
 );

Context

Pointer to a caller-defined context for the function at pfnNotify. The IEC-61883 protocol driver calls this function after a reset of the 1394 bus.

Remarks

If successful, the IEC-61883 protocol driver sets Irp->IoStatus.Status to STATUS_SUCCESS.

If an incorrect parameter is passed in, the protocol driver sets Irp->IoStatus.Status to STATUS_INVALID_PARAMETER.

Requirements

Requirement Value
Header 61883.h

See also

AV_61883_REQUEST