Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This structure is used to assign settings for a unit directory. The request exposes a unit directory within the configuration ROM of the local host. This request is used to create or remove a Configuration ROM entry in the configuration ROM of a local node. A driver is responsible for removing the Configuration ROM entries it has created before the system unloads the driver.
Syntax
typedef struct _SET_UNIT_DIRECTORY {
IN ULONG Flags;
IN ULONG UnitSpecId;
IN ULONG UnitSwVersion;
IN OUT HANDLE hCromEntry;
} SET_UNIT_DIRECTORY, *PSET_UNIT_DIRECTORY;
Members
Flags
On input, specifies whether to add or remove a unit directory. Can be ADD_UNIT_DIRECTORY_ENTRY to add a unit directory, or REMOVE_UNIT_DIRECTORY_ENTRY to remove a unit directory. If ISSUE_BUS_RESET_AFTER_MODIFY is also set, a bus reset will be issued after the add or remove.
UnitSpecId
On input, the UnitSpecId value to use within the unit directory, as defined in the IEEE 1394-1995 Specification.
UnitSwVersion
On input, the UnitSwVersion value to use within the unit directory, as defined in the IEEE 1394-1995 Specification.
hCromEntry
On input, a handle to the Configuration ROM entry.
If ADD-UNIT_DIRECTORY_ENTRY is set in Flags, hCromEntry is ignored.
If REMOVE_UNIT_DIRECTORY_ENTRY is set in Flags, hCromEntry is a handle to the Configuration ROM entry to remove.
On output, if ADD_UNIT_DIRECTORY_ENTRY is set in Flags, a handle to the newly added unit directory is written to hCromEntry.
If REMOVE_UNIT_DIRECTORY_ENTRY is set in Flags, hCromEntry is null.
Remarks
If successful, the IEC-61883 protocol driver sets Irp->IoStatus.Status to STATUS_SUCCESS.
Requirements
| Requirement | Value |
|---|---|
| Header | 61883.h |