AVC_FUNCTION_GET_PIN_DESCRIPTOR

The AVC_FUNCTION_GET_PIN_DESCRIPTOR function code obtains the pin descriptor for each pin ID (offset from zero).

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 PinDescriptor member of the AVC_MULTIFUNC_IRB structure as shown below.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PIN_DESCRIPTOR PinDescriptor;
 .
    .
    .
  };
} 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_GET_PIN_DESCRIPTOR from the AVC_FUNCTION enumeration.

PinDescriptor
Specifies the description of a pin on an AV/C subunit device.

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

In addition to the pin descriptor, this function may also return the address of an intersect handler and an opaque context value associated with the intersect handler. If the intersect handler member is NULL, the subunit driver must provide an intersect handler. If the intersect handler member is not NULL, an intersect handler is provided and the driver may use it.

Avc.sys never provides a data intersection, but a filter driver (for example, avcstrm.sys) fills it in as the request is being completed back up through the stack.

This must be called at IRQL = PASSIVE_LEVEL.

See also

AVC_MULTIFUNC_IRB

AVC_PIN_DESCRIPTOR

AVC_FUNCTION

KSPIN_DESCRIPTOR

AV/C Intersect Handler