windows-nt/Source/XPSP1/NT/drivers/published/ddk/inc/wdm/avc.w

390 lines
13 KiB
OpenEdge ABL
Raw Permalink Normal View History

2020-09-26 03:20:57 -05:00
/*++
Copyright (c) Microsoft Corporation. All rights reserved.
Module Name:
avc.h
Abstract
MS AVC Driver
Author:
PB 9/24/99
Revision History:
Date Who What
-------- --------- ------------------------------------------------------------
9/24/99 PB created
10/13/99 DG added avc protocol support
--*/
#ifndef _AVC_H_
#define _AVC_H_
#ifdef __cplusplus
extern "C" {
#endif
#ifndef CTL_CODE
#pragma message ("CTL_CODE undefined. Include winioctl.h or wdm.h")
#endif
// ctype values from AVC Digital Interface General Specification, Rev 3.0, Section 5.3.1
typedef enum _tagAvcCommandType {
AVC_CTYPE_CONTROL = 0x00,
AVC_CTYPE_STATUS = 0x01,
AVC_CTYPE_SPEC_INQ = 0x02,
AVC_CTYPE_NOTIFY = 0x03,
AVC_CTYPE_GEN_INQ = 0x04
} AvcCommandType;
// response values from AVC Digital Interface General Specification, Rev 3.0, Section 5.3.2
typedef enum _tagAvcResponseCode {
AVC_RESPONSE_NOTIMPL = 0x08,
AVC_RESPONSE_ACCEPTED = 0x09,
AVC_RESPONSE_REJECTED = 0x0a,
AVC_RESPONSE_IN_TRANSITION = 0x0b,
AVC_RESPONSE_STABLE = 0x0c,
AVC_RESPONSE_IMPLEMENTED = 0x0c,
AVC_RESPONSE_CHANGED = 0x0d,
AVC_RESPONSE_INTERIM = 0x0f
} AvcResponseCode;
// subunit type values from Enhancements to AV/C General Specification 3.0, Version 1.1, Section 7.
typedef enum _tagAvcSubunitType {
AVC_SUBUNITTYPE_VIDEO_MONITOR = 0x00,
AVC_SUBUNITTYPE_AUDIO = 0x01,
AVC_SUBUNITTYPE_PRINTER = 0x02,
AVC_SUBUNITTYPE_DISC_PLAYER = 0x03,
AVC_SUBUNITTYPE_TAPE_PLAYER = 0x04,
AVC_SUBUNITTYPE_TUNER = 0x05,
AVC_SUBUNITTYPE_CA = 0x06,
AVC_SUBUNITTYPE_VIDEO_CAMERA = 0x07,
AVC_SUBUNITTYPE_PANEL = 0x09,
AVC_SUBUNITTYPE_BULLETINBOARD = 0x0A,
AVC_SUBUNITTYPE_CAMERASTORAGE = 0x0B,
AVC_SUBUNITTYPE_VENDOR_UNIQUE = 0x1c,
AVC_SUBUNITTYPE_EXTENDED = 0x1e,
AVC_SUBUNITTYPE_EXTENDED_FULL = 0xff, // This is used only in extension bytes
AVC_SUBUNITTYPE_UNIT = 0x1f
} AvcSubunitType;
#ifdef _NTDDK_
#define STATIC_KSMEDIUMSETID_1394SerialBus\
0x9D46279FL, 0x3432, 0x48F3, 0x88, 0x8A, 0xEE, 0xFF, 0x1B, 0x7E, 0xEE, 0x71
DEFINE_GUIDSTRUCT("9D46279F-3432-48F3-888A-EEFF1B7EEE71", KSMEDIUMSETID_1394SerialBus);
#define KSMEDIUMSETID_1394SerialBus DEFINE_GUIDNAMED(KSMEDIUMSETID_1394SerialBus)
#define DEFAULT_AVC_TIMEOUT (1000000L) // 100ms in 100 nanosecond units
#define DEFAULT_AVC_RETRIES 9 // 10 tries altogether
// Max pages available via the SUBUNIT INFO command
#define MAX_AVC_SUBUNITINFO_PAGES 8
// Max number of bytes of subunit address information per page
#define MAX_AVC_SUBUNITINFO_BYTES 4
// Combined subunit address byte count for all pages
#define AVC_SUBUNITINFO_BYTES (MAX_AVC_SUBUNITINFO_PAGES * MAX_AVC_SUBUNITINFO_BYTES)
//
// IOCTL definitions
//
#define IOCTL_AVC_CLASS CTL_CODE( \
FILE_DEVICE_UNKNOWN, \
0x92, \
METHOD_BUFFERED, \
FILE_ANY_ACCESS \
)
typedef enum _tagAVC_FUNCTION {
AVC_FUNCTION_COMMAND = 0, // struct AVC_COMMAND_IRB
AVC_FUNCTION_GET_PIN_COUNT = 1, // struct AVC_PIN_COUNT
AVC_FUNCTION_GET_PIN_DESCRIPTOR = 2, // struct AVC_PIN_DESCRIPTOR
AVC_FUNCTION_GET_CONNECTINFO = 3, // struct AVC_PRECONNECT_INFO
AVC_FUNCTION_SET_CONNECTINFO = 4, // struct AVC_SETCONNECT_INFO
AVC_FUNCTION_ACQUIRE = 5, // struct AVC_PIN_ID
AVC_FUNCTION_RELEASE = 6, // struct AVC_PIN_ID
AVC_FUNCTION_CLR_CONNECTINFO = 7, // struct AVC_PIN_ID
AVC_FUNCTION_GET_EXT_PLUG_COUNTS = 8, // struct AVC_EXT_PLUG_COUNTS
AVC_FUNCTION_GET_UNIQUE_ID = 9, // struct AVC_UNIQUE_ID
AVC_FUNCTION_GET_REQUEST = 10, // struct AVC_COMMAND_IRB
AVC_FUNCTION_SEND_RESPONSE = 11, // struct AVC_COMMAND_IRB
AVC_FUNCTION_FIND_PEER_DO = 12, // struct AVC_PEER_DO_LOCATOR
AVC_FUNCTION_PEER_DO_LIST = 13, // struct AVC_PEER_DO_LIST
AVC_FUNCTION_GET_SUBUNIT_INFO = 14, // struct AVC_SUBUNIT_INFO_BLOCK
} AVC_FUNCTION;
// Ensure that packing is consistent (/Zp8)
#include <pshpack8.h>
// This structure is to be included at the head of a more specific AVC function structure
typedef struct _AVC_IRB {
AVC_FUNCTION Function;
} AVC_IRB, *PAVC_IRB;
// The maximum number of bytes available for an operand list
#define MAX_AVC_OPERAND_BYTES 509
// AVC_COMMAND_IRB
//
// This structure defines the common components of an AVC command request. It
// holds the opcode and operands of a request, and the opcode and operands
// of a response (upon completion). The size of the operand list is fixed at
// the maximum allowable number of operands given a one-byte Subunit Address.
// If the Subunit Address is extended in any way, the maximum permissible
// number of operand bytes will be reduced accordingly.
// (supported by peer and virtual instances)
typedef struct _AVC_COMMAND_IRB {
// AVC_FUNCTION_COMMAND
#ifdef __cplusplus
AVC_IRB Common;
#else
AVC_IRB;
#endif
UCHAR SubunitAddrFlag : 1; // set to 1 if a SubunitAddr address is specified
UCHAR AlternateOpcodesFlag : 1; // set to 1 if the AlternateOpcodes address is specified
UCHAR TimeoutFlag : 1; // set to 1 if Timeout specified
UCHAR RetryFlag : 1; // set to 1 if Retries specified
// On command request, this struct will use the CommandType
// On command response, this struct will use ResponseCode
union {
UCHAR CommandType;
UCHAR ResponseCode;
};
PUCHAR SubunitAddr; // set according to the target device object if not specified
PUCHAR AlternateOpcodes; // set to the address of an array of alternate opcodes (byte 0
// is the count of alternate opcodes that follow)
LARGE_INTEGER Timeout; // Defaults to DEFAULT_AVC_TIMEOUT if not specified
UCHAR Retries; // Defaults to DEFAULT_AVC_RETRIES if not specified
// The total amount of time a request will wait if the subunit is not responsive is:
// Timeout * (Retries+1)
UCHAR Opcode;
ULONG OperandLength; // set to the actual length of the operand list
UCHAR Operands[MAX_AVC_OPERAND_BYTES];
NODE_ADDRESS NodeAddress; // Used by virtual devices, ignored otherwise
ULONG Generation; // Used by virtual devices, ignored otherwise
} AVC_COMMAND_IRB, *PAVC_COMMAND_IRB;
// For AVC_FUNCTION_GET_PIN_COUNT (supported by peer instance only)
//
typedef struct _AVC_PIN_COUNT {
OUT ULONG PinCount; // The pin count
} AVC_PIN_COUNT, *PAVC_PIN_COUNT;
// Dataformat Intersection handler used in struct AVC_PIN_DESCRIPTOR
typedef
NTSTATUS
(*PFNAVCINTERSECTHANDLER)(
IN PVOID Context,
IN ULONG PinId,
IN PKSDATARANGE DataRange,
IN PKSDATARANGE MatchingDataRange,
IN ULONG DataBufferSize,
OUT PVOID Data OPTIONAL,
OUT PULONG DataSize
);
// For AVC_FUNCTION_GET_PIN_DESCRIPTOR (supported by peer instance only)
//
typedef struct _AVC_PIN_DESCRIPTOR {
IN ULONG PinId; // The pin number
OUT KSPIN_DESCRIPTOR PinDescriptor;
OUT PFNAVCINTERSECTHANDLER IntersectHandler;
OUT PVOID Context;
} AVC_PIN_DESCRIPTOR, *PAVC_PIN_DESCRIPTOR;
#define AVCCONNECTINFO_MAX_SUBUNITADDR_LEN AVC_SUBUNITINFO_BYTES
typedef enum _KSPIN_FLAG_AVC {
KSPIN_FLAG_AVCMASK = 0x03, // the mask to isolate the AV/C defined bit flags
KSPIN_FLAG_AVC_PERMANENT = 0x01, // part of the AV/C Connect Status bit flag
KSPIN_FLAG_AVC_CONNECTED = 0x02, // part of the AV/C Connect Status bit flag
KSPIN_FLAG_AVC_PCRONLY = 0x04, // no subunit plug control
KSPIN_FLAG_AVC_FIXEDPCR = 0x08, // implies KSPIN_FLAG_AVC_PERMANENT
} KSPIN_FLAG_AVC;
typedef struct _AVCPRECONNECTINFO {
// Unique ID of the target unit
GUID DeviceID;
UCHAR SubunitAddress[AVCCONNECTINFO_MAX_SUBUNITADDR_LEN];
ULONG SubunitPlugNumber;
KSPIN_DATAFLOW DataFlow;
// KSPIN_FLAG_AVC_...
ULONG Flags;
// Undefined if !(Flags & KSPIN_FLAG_AVC_FIXEDPCR)
ULONG UnitPlugNumber;
} AVCPRECONNECTINFO, *PAVCPRECONNECTINFO;
// For AVC_FUNCTION_GET_CONNECTINFO (supported by peer instance only)
//
typedef struct _AVC_PRECONNECT_INFO {
IN ULONG PinId; // The pin number
OUT AVCPRECONNECTINFO ConnectInfo;
} AVC_PRECONNECT_INFO, *PAVC_PRECONNECT_INFO;
typedef struct _AVCCONNECTINFO {
// Unique ID of the target unit
GUID DeviceID;
UCHAR SubunitAddress[AVCCONNECTINFO_MAX_SUBUNITADDR_LEN];
ULONG SubunitPlugNumber;
KSPIN_DATAFLOW DataFlow;
// NULL if intra-unit connection
HANDLE hPlug;
// Undefined if hPlug == NULL
ULONG UnitPlugNumber;
} AVCCONNECTINFO, *PAVCCONNECTINFO;
// For AVC_FUNCTION_SET_CONNECTINFO (supported by peer instance only)
//
typedef struct _AVC_SETCONNECT_INFO {
IN ULONG PinId; // The pin number
IN AVCCONNECTINFO ConnectInfo;
} AVC_SETCONNECT_INFO, *PAVC_SETCONNECT_INFO;
// For AVC_FUNCTION_ACQUIRE or AVC_FUNCTION_RELEASE or AVC_FUNCTION_CLR_CONNECTINFO (supported by peer instance only)
//
typedef struct _AVC_PIN_ID {
IN ULONG PinId; // The pin ID
} AVC_PIN_ID, *PAVC_PIN_ID;
// For AVC_FUNCTION_GET_EXT_PLUG_COUNTS (supported by peer instance only)
//
typedef struct _AVC_EXT_PLUG_COUNTS {
OUT ULONG ExtInputs;
OUT ULONG ExtOutputs;
} AVC_EXT_PLUG_COUNTS, *PAVC_EXT_PLUG_COUNTS;
// For AVC_FUNCTION_GET_UNIQUE_ID (supported by peer instance only)
//
typedef struct _AVC_UNIQUE_ID {
// Unique ID of the target unit
OUT GUID DeviceID;
} AVC_UNIQUE_ID, *PAVC_UNIQUE_ID;
// For AVC_FUNCTION_FIND_PEER_DO
//
typedef struct _AVC_PEER_DO_LOCATOR {
// 1394 NodeAddress identifying target for query
IN NODE_ADDRESS NodeAddress;
IN ULONG Generation;
OUT PDEVICE_OBJECT DeviceObject;
} AVC_PEER_DO_LOCATOR, *PAVC_PEER_DO_LOCATOR;
// For AVC_FUNCTION_PEER_DO_LIST
//
typedef struct _AVC_PEER_DO_LIST {
// Counted array of referenced device objects (allocated by target)
OUT ULONG Count;
OUT PDEVICE_OBJECT *Objects;
} AVC_PEER_DO_LIST, *PAVC_PEER_DO_LIST;
// For AVC_FUNCTION_GET_SUBUNIT_INFO
//
typedef struct _AVC_SUBUNIT_INFO_BLOCK {
// Array of bytes to hold subunit info (see AV/C SUBUNIT_INFO unit command for format)
OUT UCHAR Info[AVC_SUBUNITINFO_BYTES];
} AVC_SUBUNIT_INFO_BLOCK, *PAVC_SUBUNIT_INFO_BLOCK;
typedef struct _AVC_MULTIFUNC_IRB {
#ifdef __cplusplus
AVC_IRB Common;
#else
AVC_IRB;
#endif
union {
AVC_PIN_COUNT PinCount; // AVC_FUNCTION_GET_PIN_COUNT
AVC_PIN_DESCRIPTOR PinDescriptor; // AVC_FUNCTION_GET_PIN_DESCRIPTOR
AVC_PRECONNECT_INFO PreConnectInfo; // AVC_FUNCTION_GET_CONNECTINFO
AVC_SETCONNECT_INFO SetConnectInfo; // AVC_FUNCTION_SET_CONNECTINFO
AVC_PIN_ID PinId; // AVC_FUNCTION_ACQUIRE or
// AVC_FUNCTION_RELEASE or
// AVC_FUNCTION_CLR_CONNECTINFO
AVC_EXT_PLUG_COUNTS ExtPlugCounts; // AVC_FUNCTION_GET_EXT_PLUG_COUNTS
AVC_UNIQUE_ID UniqueID; // AVC_FUNCTION_GET_UNIQUE_ID
AVC_PEER_DO_LOCATOR PeerLocator; // AVC_FUNCTION_FIND_PEER_DO
AVC_PEER_DO_LIST PeerList; // AVC_FUNCTION_PEER_DO_LIST
AVC_SUBUNIT_INFO_BLOCK Subunits; // AVC_FUNCTION_GET_SUBUNIT_INFO
};
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;
#include <poppack.h>
#endif // _NTDDK_
//
// IOCTL definitions for Virtual Unit control (from user mode)
//
#define IOCTL_AVC_UPDATE_VIRTUAL_SUBUNIT_INFO CTL_CODE(FILE_DEVICE_BUS_EXTENDER, 0x000, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_AVC_REMOVE_VIRTUAL_SUBUNIT_INFO CTL_CODE(FILE_DEVICE_BUS_EXTENDER, 0x001, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_AVC_BUS_RESET CTL_CODE(FILE_DEVICE_BUS_EXTENDER, 0x002, METHOD_BUFFERED, FILE_ANY_ACCESS)
// Ensure that packing is consistent (/Zp8)
#include <pshpack8.h>
typedef struct _AVC_SUBUNIT_ADDR_SPEC {
ULONG Flags;
UCHAR SubunitAddress[1];
} AVC_SUBUNIT_ADDR_SPEC, *PAVC_SUBUNIT_ADDR_SPEC;
// Flags, when used with IOCTL_AVC_UPDATE_VIRTUAL_SUBUNIT_INFO
// and IOCTL_AVC_REMOVE_VIRTUAL_SUBUNIT_INFO
#define AVC_SUBUNIT_ADDR_PERSISTENT 0x00000001
#define AVC_SUBUNIT_ADDR_TRIGGERBUSRESET 0x00000002
#include <poppack.h>
#ifdef __cplusplus
}
#endif
#endif // _AVC_H_
#ifndef AVC_GUIDS_DEFINED
#define AVC_GUIDS_DEFINED
// {616EF4D0-23CE-446d-A568-C31EB01913D0}
DEFINE_GUID(GUID_VIRTUAL_AVC_CLASS, 0x616ef4d0, 0x23ce, 0x446d, 0xa5, 0x68, 0xc3, 0x1e, 0xb0, 0x19, 0x13, 0xd0);
// {095780C3-48A1-4570-BD95-46707F78C2DC}
DEFINE_GUID(GUID_AVC_CLASS, 0x095780c3, 0x48a1, 0x4570, 0xbd, 0x95, 0x46, 0x70, 0x7f, 0x78, 0xc2, 0xdc);
#endif