FN_VMB_PACKET_INITIALIZE função de retorno de chamada (vmbuskernelmodeclientlibapi.h)
[Algumas informações referem-se ao produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não faz garantias, expressas ou implícitas, em relação às informações fornecidas aqui.]
A função VmbPacketInitialize inicializa um buffer para conter um pacote VMBus.
Sintaxe
FN_VMB_PACKET_INITIALIZE FnVmbPacketInitialize;
NTSTATUS FnVmbPacketInitialize(
VMBCHANNEL Channel,
VMBPACKET VmbPacket,
UINT32 ByteCount
)
{...}
Parâmetros
Channel
Um identificador para um canal.
VmbPacket
O buffer a ser usado para armazenar o pacote VMBus.
ByteCount
O tamanho de de buffer de, em bytes.
Valor de retorno
VmbPacketInitialize retorna os seguintes códigos de status:
| Código de retorno | Descrição |
|---|---|
|
A função foi concluída com êxito. |
|
O valor de ByteCount não é válido. Ele precisa ser maior que o tamanho máximo do pacote mais o tamanho de um ponteiro nulo. |
Observações
O tamanho do buffer deve ser pelo menos o tamanho calculado usando a função VmbChannelSizeofPacket.
VmbPacketInitialize é uma alternativa à função VmbPacketAllocate. Use a função atual se o chamador fornecer a memória do objeto de pacote.
A rotina de conclusão inicial do pacote é inválida e deve ser definida antes de enviar o pacote.
Importante
Essa função é chamada por meio da interface KMCL (Biblioteca de Clientes do Modo Kernel do VMBus), fornecida pelo driver de barramento Vmbkmcl.sys. Essa é uma função cliente acessada da estrutura de KMCL_CLIENT_INTERFACE_V1.
Para obter mais informações, consulte a seção Comentários do KMCL_CLIENT_INTERFACE_V1.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1803 |
| cabeçalho | vmbuskernelmodeclientlibapi.h |