Compartir a través de


Funciones de clase port obsoletas

Macros portcls.hdefines del archivo de encabezado que contienen los nombres de funciones PortCls obsoletas que se han reemplazado por las nuevas funciones de PortCls. Estas macros permiten volver a compilar el código fuente antiguo que contiene referencias a nombres de función PortCls obsoletos para usar las nuevas funciones PortCls sin necesidad de modificaciones en los archivos de origen.

Al compilar código fuente que usa los nombres obsoletos, defina el nombre del parámetro PC_OLD_NAMES. Este parámetro se puede definir mediante el argumento de línea de comandos del compilador "-DPC_OLD_NAMES" si es más conveniente que introducir la instrucción #define PC_OLD_NAMES en los propios archivos de origen.

En la tabla siguiente se enumeran los nombres de función PortCls obsoletos en la columna izquierda. Para cada nombre obsoleto, la columna central contiene el nombre de la nueva función PortCls que la reemplaza.

Nombre de función obsoleto Nuevo nombre de función ¿Cambiaron los argumentos?

AddAdapterDevice

PcAddAdapterDevice

CompletePendingPropertyRequest

PcCompletePendingPropertyRequest

no

GetTimeInterval

PcGetTimeInterval

no

InitializeAdapterDriver

PcInitializeAdapterDriver

NewDmaChannel

PcNewDmaChannel

no

NewMiniport

PcNewMiniport

no

Newport

PcNewPort

no

NewResourceList

PcNewResourceList

no

NewResourceSublist

PcNewResourceSublist

no

NewServiceGroup

PcNewServiceGroup

no

RegisterPhysicalConnection

PcRegisterPhysicalConnection

RegisterPhysicalConnectionFromExternal

PcRegisterPhysicalConnectionFromExternal

RegisterPhysicalConnectionToExternal

PcRegisterPhysicalConnectionToExternal

RegisterSubdevice

PcRegisterSubdevice

En algunos casos, el cambio equivale a no más que un simple cambio de nombre: el calificador Pc se inserta al principio del nombre para indicar que la función se implementa en PortCls. Sin embargo, en otros casos, la lista de argumentos ha cambiado además del nombre de la función. La columna derecha de la tabla anterior indica si los argumentos han cambiado.

En los casos en los que los argumentos cambiaron, las macros de portcls.hconvertirán las listas de argumentos de las funciones PortCls obsoletas a los argumentos equivalentes de las nuevas funciones PortCls. Las macros siguientes contienen conversiones de argumentos:

#define InitializeAdapterDriver(c1,c2,a) \
    PcInitializeAdapterDriver(PDRIVER_OBJECT(c1),PUNICODE_STRING(c2),PDRIVER_ADD_DEVICE(a))
#define AddAdapterDevice(c1,c2,s,m) \
    PcAddAdapterDevice(PDRIVER_OBJECT(c1),PDEVICE_OBJECT(c2),s,m,0)
#define RegisterSubdevice(c1,c2,n,u) \
    PcRegisterSubdevice(PDEVICE_OBJECT(c1),n,u)
#define RegisterPhysicalConnection(c1,c2,fs,fp,ts,tp) \
    PcRegisterPhysicalConnection(PDEVICE_OBJECT(c1),fs,fp,ts,tp)
#define RegisterPhysicalConnectionToExternal(c1,c2,fs,fp,ts,tp) \
    PcRegisterPhysicalConnectionToExternal(PDEVICE_OBJECT(c1),fs,fp,ts,tp)
#define RegisterPhysicalConnectionFromExternal(c1,c2,fs,fp,ts,tp) \
    PcRegisterPhysicalConnectionFromExternal(PDEVICE_OBJECT(c1),fs,fp,ts,tp)