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 create a plug. The request creates an input or output plug control register (iPCR or oPCR) on the local host. A driver is responsible for deleting all of the plugs it has created before the system unloads the driver.
Syntax
typedef struct _CMP_CREATE_PLUG {
IN CMP_PLUG_TYPE PlugType;
IN AV_PCR Pcr;
IN PCMP_NOTIFY_ROUTINE pfnNotify;
IN PVOID Context;
OUT ULONG PlugNum;
OUT HANDLE hPlug;
} CMP_CREATE_PLUG, *PCMP_CREATE_PLUG;
Members
PlugType
On input, the type of plug to create. Can be one of the following:
CMP_PlugOut
An output plug, which transmits data from the device to the bus.
CMP_PlugIn
An input plug, which receives data sent by the bus to the device.
Pcr
On input, an AV_PCR structure that contains values used by the protocol driver to initialize the plug.
pfnNotify
On input, a pointer to a caller-supplied function to be called by the protocol driver when the plug is created.
Context
On input, a pointer to an optional caller-supplied context for the function at pfnNotify.
PlugNum
On output, the plug number.
hPlug
On output, the handle of the created plug
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.
If the protocol driver is unable to allocate resources, it sets Irp->IoStatus.Status to STATUS_INSUFFICIENT_RESOURCES.
Requirements
| Requirement | Value |
|---|---|
| Header | 61883.h |