IEEE1394_API_REQUEST structure
Drivers and user-level software manage virtual IEEE1394 devices by means of a special kind of request defined in the IEEE1394_API_REQUEST structure. The bus driver receives these requests and takes the action indicated in the RequestNumber member.
Syntax
typedef struct _IEEE1394_API_REQUEST {
ULONG RequestNumber;
ULONG Flags;
union {
IEEE1394_API_ADD_VIRTUAL_DEVICE AddVirtualDevice;
IEEE1394_API_REMOVE_VIRTUAL_DEVICE RemoveVirtualDevice;
} u;
} IEEE1394_API_REQUEST, *PIEEE1394_API_REQUEST;
Members
RequestNumber
Determines the type of request. Each request type is documented under the value of RequestNumber in IEEE 1394 Bus I/O Requests.Flags
A flag that describes the request.Flag Description IEEE1394_REQUEST_FLAG_UNICODE
The text string supplied in this structure is in Unicode.
IEEE1394_REQUEST_FLAG_PERSISTENT
Automatically re-create the virtual device on every boot.
IEEE1394_REQUEST_FLAG_USE_LOCAL_HOST_EUI
Use the instance ID of the host controller to define the instance ID of the virtual device to be created.
u
Specifies a union of structures, one for each value of RequestNumber. The applicable submembers of u for each request are described with each request type in IEEE 1394 Bus I/O Requests.RequestNumber Associated Member IEEE1394_API_REMOVE_VIRTUAL_DEVIC
u.AddVirtualDevice
IEEE1394_API_REMOVE_VIRTUAL_DEVIC
u.RemoveVirtualDevice
Remarks
The AssociatedIrp.SystemBuffer->SystemBuffer member of an IOCTL_IEEE1394_API_REQUEST IRP points to an IEEE1394_API_REQUEST 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