새 PortCls 함수로 대체된 사용되지 않는 PortCls 함수의 이름이 포함된 헤더 파일 portcls.hdefines 매크로입니다. 이러한 매크로를 사용하면 오래된 PortCls 함수 이름에 대한 참조가 포함된 이전 소스 코드를 다시 컴파일하여 원본 파일을 편집할 필요 없이 새 PortCls 함수를 사용할 수 있습니다.
사용되지 않는 이름을 사용하는 소스 코드를 컴파일할 때 매개 변수 이름 PC_OLD_NAMES 정의합니다. 이 매개 변수는 소스 파일 자체에 문을 #define PC_OLD_NAMES 도입하는 것보다 더 편리한 경우 컴파일러 명령줄 인수 "-DPC_OLD_NAMES"으로 정의할 수 있습니다.
다음 표에는 왼쪽 열의 사용되지 않는 PortCls 함수 이름이 나열되어 있습니다. 사용되지 않는 각 이름에 대해 가운데 열에는 해당 이름을 대체하는 새 PortCls 함수의 이름이 포함됩니다.
| 사용되지 않는 함수 이름 | 새 함수 이름 | 인수가 변경했나요? |
|---|---|---|
AddAdapterDevice |
YES |
|
CompletePendingPropertyRequest |
아니요 |
|
GetTimeInterval |
아니요 |
|
InitializeAdapterDriver |
YES |
|
NewDmaChannel |
아니요 |
|
NewMiniport |
아니요 |
|
뉴포트 |
아니요 |
|
NewResourceList |
아니요 |
|
NewResourceSublist |
아니요 |
|
NewServiceGroup |
아니요 |
|
RegisterPhysicalConnection |
YES |
|
RegisterPhysicalConnectionFromExternal |
YES |
|
RegisterPhysicalConnectionToExternal |
YES |
|
RegisterSubdevice |
YES |
경우에 따라 변경 내용은 단순한 이름 변경에 해당하지 않습니다. 한정 Pc 자는 PortCls에서 함수가 구현되었음을 나타내기 위해 이름 시작 부분에 삽입됩니다. 그러나 다른 경우에는 함수 이름 외에도 인수 목록이 변경되었습니다. 앞의 표에 있는 오른쪽 열은 인수가 변경되었는지 여부를 나타냅니다.
인수가 변경된 경우 portcls.h의 매크로는 사용되지 않는 PortCls 함수의 인수 목록을 새 PortCls 함수에 해당하는 인수로 변환합니다. 다음 매크로에는 인수 변환이 포함됩니다.
#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)