AVC_FUNCTION_ACQUIRE
The AVC_FUNCTION_ACQUIRE function code causes avc.sys to establish any connections suggested by cached AVCCONNECTINFO values.
I/O Status Block
If successful, the AV/C protocol driver sets Irp->IoStatus.Status to STATUS_SUCCESS.
Possible other return values include:
| Return value | Description |
|---|---|
| STATUS_TIMEOUT | The request was made, but no response was received before all time-out and retry processing was complete. |
| STATUS_REQUEST_ABORTED | Immediately abort when the IRP completion status is STATUS_REQUEST_ABORTED. This indicates that the device has been removed or is no longer available on the 1394 bus. |
| STATUS_* | Any other return code indicates that an error or warning occurred that was beyond the scope of the AV/C protocol. |
Comments
This function uses the PinId member of the AVC_MULTIFUNC_IRB structure as shown below.
typedef struct _AVC_MULTIFUNC_IRB {
AVC_IRB Common;
union {
.
.
.
AVC_PIN_ID PinId;
.
.
.
};
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;
Requirements
Headers: Declared in avc.h. Include avc.h.
AVC_MULTIFUNC_IRB Input
Common
The Function submember of this member must be set to AVC_FUNCTION_ACQUIRE from the AVC_FUNCTION enumeration.
PinId
Specifies the offset (or ID) of the pin for which a connection is to be acquired.
This function code is not supported by virtual instances of avc.sys.
A subunit driver must use this function when the pin becomes active.
This must be called at IRQL = PASSIVE_LEVEL.