O cabeçalho
O cabeçalho a seguir representa um dos estilos de cabeçalho que podem ser gerados pela versão atual do MIDL. Para sua conveniência, a lista completa de campos de cabeçalho é fornecida aqui.
handle_type<1>
Oi_flags<1>
[rpc_flags<4>]
proc_num<2>
stack_size<2>
[explicit_handle_description<>]
constant_client_buffer_size<2>
constant_server_buffer_size<2>
INTERPRETER_OPT_FLAGS<1>
number_of_params<1>
Extensões a partir do Windows 2000: <8> para 32 bits, <12> para 64 bits)
extension_version<1>
INTERPRETER_OPT_FLAGS2<1>
ClientCorrHint<2>
ServerCorrHint<2>
NotifyIndex<2>
[ FloatDoubleMask<2> ]
O extension_version<1> fornece o tamanho da seção de extensão, em bytes. Isso possibilita que o mecanismo de NDR atual percorra a seção de extensão corretamente, mesmo que a seção venha de uma versão posterior do compilador com mais campos do que o mecanismo atual entende.
As INTERPRETER_OPT_FLAGS2 são definidas da seguinte maneira:
typedef struct
{
unsigned char HasNewCorrDesc : 1; // 0x01
unsigned char ClientCorrCheck : 1; // 0x02
unsigned char ServerCorrCheck : 1; // 0x04
unsigned char HasNotify : 1; // 0x08
unsigned char HasNotify2 : 1; // 0x10
unsigned char Unused : 3;
} INTERPRETER_OPT_FLAGS2, *PINTERPRETER_OPT_FLAGS2;
O membro HasNewCorrDesc indica se novos descritores de correlação são usados nas cadeias de caracteres de formato geradas pelo compilador. O novo descritor de correlação está relacionado à funcionalidade de negação de ataque. Os membros ClientCorrCheck e ServerCorrCheck são definidos quando a rotina precisa da correlação marcar no lado indicado.
Os sinalizadores HasNotify e HasNotify2 indicam que a rotina usa o recurso de notificação conforme definido pelos atributos [notify] e [notify_flag] , respectivamente.
O membro ClientCorrHint é uma dica de tamanho de cache no lado do cliente e ServerCorrHint é uma dica no lado do servidor. Quando o tamanho sai como zero, um tamanho padrão deve ser usado.
O elemento NotifyIndex é um índice para uma rotina de notificação, se um for usado.
O elemento FloatDoubleMask aborda o problema de um argumento de ponto flutuante para Windows de 64 bits. Esse campo é gerado apenas para stubs de 64 bits. A máscara é necessária para as rotinas de assembly que baixam/carregam registros de/para a pilha virtual para lidar com argumentos de ponto flutuante e registra corretamente. A máscara consiste em 2 bits por argumento ou, em vez disso, por registro de ponto flutuante. A codificação é a seguinte: os bits menos significativos correspondem ao primeiro registro fp, os próximos 2 bits correspondem ao segundo registro e assim por diante.
Observação
Para rotinas de objeto, o primeiro argumento acaba no segundo registro devido a esse ponteiro ser o primeiro. Para cada registro, o significado de bits é conforme mostrado na tabela a seguir.
Bits | Significado |
---|---|
01 | Um valor float deve ser carregado no registro. |
10 | Um valor duplo deve ser carregado no registro. |
00 e 11 são valores inválidos para os bits.
Atualmente, há oito registros FP em um processador intel architecture de 64 bits, portanto, a máscara pode ter apenas 16b bits mais baixos definidos. O tamanho da máscara foi definido como um total de 16 bits com base na máscara do compilador C permanecendo inalterada.
Para simplificar o código e melhorar o desempenho, o compilador tenta gerar um cabeçalho de tamanho fixo sempre que possível. Em particular, o seguinte cabeçalho é usado para DCOM assíncrono:
typedef struct _NDR_DCOM_OI2_PROC_HEADER
{
unsigned char HandleType; // The Oi header
INTERPRETER_FLAGS OldOiFlags; //
unsigned short RpcFlagsLow; //
unsigned short RpcFlagsHi; //
unsigned short ProcNum; //
unsigned short StackSize; //
// expl handle descr is never generated //
unsigned short ClientBufferSize; // The Oi2 header
unsigned short ServerBufferSize; //
INTERPRETER_OPT_FLAGS Oi2Flags; //
unsigned char NumberParams; //
} NDR_DCOM_OI2_PROC_HEADER, *PNDR_DCOM_OI2_PROC_HEADER;