MarshalledBuffer_t

9/8/2008

Essa classe é um wrapper para o CeOpenCallerBuffer, a CeCloseCallerBuffer, a CeAllocAsynchronousBuffere as funções CeFreeAsynchronousBuffer. Apenas usá-lo com incorporado ponteiros que foram ainda não esteja acesso-verificado ou empacotados pelo kernel.

Para duplicado uma reserva que já foi empacotada, use a função DuplicatedBuffer_t. Para obter assíncrono acessar para uma reserva que já foi empacotada, use a função AsynchronousBuffer_t.

Syntax

class MarshalledBuffer_t {
public:
   MarshalledBuffer_t()
        MarshalledBuffer_t()

      MarshalledBuffer_t(
            PVOID pSrcUnmarshalled,
            DWORD cbSrc,
            DWORD ArgumentDescriptor,
            BOOL  ForceDuplicate = TRUE,
            BOOL  Asynchronous = FALSE
      );

      MarshalledBuffer_t(
            PCVOID pSrcUnmarshalled,
          DWORD cbSrc,
            DWORD ArgumentDescriptor,
            BOOL  ForceDuplicate = TRUE,
            BOOL  Asynchronous = FALSE
      );

      HRESULT Marshal(
            PVOID pSrcUnmarshalled,
            DWORD cbSrc,
            DWORD ArgumentDescriptor,
            BOOL  ForceDuplicate = TRUE,
            BOOL  Asynchronous = FALSE
      );

      HRESULT Marshal(
            PCVOID pSrcUnmarshalled,
            DWORD cbSrc,
            DWORD ArgumentDescriptor,
            BOOL  ForceDuplicate = TRUE,
            BOOL  Asynchronous = FALSE
      );

      HRESULT Flush();
      HRESULT Unmarshal();
          LPVOID ptr() const;
          DWORD size() const;
};

Métodos

MarshalledBuffer_t();
~MarshalledBuffer_t();

MarshalledBuffer_t(
    PVOID pSrcUnmarshalled,
    DWORD cbSrc,
    DWORD ArgumentDescriptor,
    BOOL  ForceDuplicate = TRUE,
    BOOL  Asynchronous = FALSE
);

MarshalledBuffer_t(
    PCVOID pSrcUnmarshalled,
    DWORD cbSrc,
    DWORD ArgumentDescriptor,
    BOOL  ForceDuplicate = TRUE,
    BOOL  Asynchronous = FALSE
);

AsynchronousBuffer_t {
    PVOID  pSrcMarshalled,
    DWORD cbSrc,
    DWORD ArgumentDescriptor
};

AsynchronousBuffer_t {
    PCVOID  pSrcMarshalled,
    DWORD cbSrc,
    DWORD ArgumentDescriptor
};

DuplicatedBuffer_t {
    PVOID  pSrcMarshalled,
    DWORD cbSrc,
    DWORD ArgumentDescriptor
};

DuplicatedBuffer_t(
    PCVOID pSrcMarshalled,
    DWORD cbSrc,
    DWORD ArgumentDescriptor
);

HRESULT Marshal(
    PVOID pSrcUnmarshalled,
    DWORD cbSrc,
    DWORD ArgumentDescriptor,
    BOOL  ForceDuplicate = TRUE,
    BOOL  Asynchronous = FALSE
);

HRESULT Marshal(
    PCVOID pSrcUnmarshalled,
    DWORD cbSrc,
    DWORD ArgumentDescriptor,
    BOOL  ForceDuplicate = TRUE,
    BOOL  Asynchronous = FALSE
);

HRESULT Flush();

HRESULT Unmarshal();

LPVOID ptr() const;

DWORD size() const;

Remarks

Você pode escolher para otimizar grande assíncrono reserva acessa usando o sinalizador MARSHAL_FORCE_ALIAS. Se seu codificar é execução dentro de processo kernel e você estiver usando um microprocessador ARM com um praticamente marcados armazenar em cache, você pode transmitir MARSHAL_FORCE_ALIAS como parte das ArgumentDescriptor. Em todos os outras CPUs, MARSHAL_FORCE_ALIAS não tem nenhum efeito.

Não use o sinalizador MARSHAL_FORCE_ALIAS a menos que você esteja usando buffers maiores 16 KB.

Nas CPUs ARM que usam um praticamente marcados armazenar em cache, dentro de processo kernel, CeAllocAsynchronousBuffer Cria um duplicado copiar da memória no heap Por padrão. Em grandes buffers, criando o duplicado heap pode afetar desempenho. Para evitar duplicação, transmitir o sinalizador MARSHAL_FORCE_ALIAS para causar CeAllocAsynchronousBuffer Para criar um alias, em vez disso. No entanto, a criação de memória de alias em ARM CPUs que usam um praticamente marcados causas armazenar em cache de origem e destino memória para serem acessados como uncached, até que o alias é destruída por CeFreeAsynchronousBuffer. Isso significa que o acessa memória se tornar mais lenta na origem e destino.

Em todas as CPUs, Dentro usuário-modo processos, CeAllocAsynchronousBuffer Sempre cria um duplicado da memória com VirtualCopy, independentemente se o sinalizador MARSHAL_FORCE_ALIAS é passado. Não é possível para forçar a criação de um alias do modo usuário.

Se você transmitir MARSHAL_FORCE_ALIAS para CeAllocAsynchronousBuffer, você deve também transmiti-lo quando você chamar CeFlushAsynchronousBuffer e CeFreeAsynchronousBuffer. Não passa pode causar o sistema fique sem resposta ou vazamentos recurso.

A seguinte tabela descreve os descritores.

Requirements

See Also

Reference

Kernel Buffer Marshaling Classes
CeOpenCallerBuffer
CeCloseCallerBuffer
CeAllocAsynchronousBuffer
CeFlushAsynchronousBuffer
CeFreeAsynchronousBuffer
DuplicatedBuffer_t
AsynchronousBuffer_t

Other Resources

Developing a Device Driver
Kernel Migration
Bringing Up a Hardware Platform