AVC_FUNCTION_CLR_CONNECTINFO

The AVC_FUNCTION_CLR_CONNECT_INFO function code causes avc.sys to remove any 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_CLR_CONNECTINFO from the AVC_FUNCTION enumeration.

PinId
Specifies the offset (or ID) of the pin for which a connection is to be released.

This function code is not supported by virtual instances of avc.sys.

A subunit driver must use this function when the plug connections should no longer be made, even if the pin becomes "active" again.

This must be called at IRQL = PASSIVE_LEVEL.

See also

AVC_MULTIFUNC_IRB

AVC_PIN_ID

AVC_FUNCTION