SRIOV_WRITE_BLOCK função de retorno de chamada (pcivirt.h)

Artigo
02/07/2025

Grava dados no bloco de configuração especificado de um PCI Express SR-IOV Virtual Function (VF).

Sintaxe

SRIOV_WRITE_BLOCK SriovWriteBlock;

NTSTATUS SriovWriteBlock(
  [in] PVOID Context,
  [in] USHORT VfIndex,
  [in] ULONG BlockId,
  [in] PVOID Buffer,
       ULONG Length
)
{...}

Parâmetros

[in] Context

Um ponteiro para um contexto definido pelo driver.

[in] VfIndex

Um índice baseado em zero do VF ao qual essa operação de gravação se aplica.

[in] BlockId

Um número que identifica o bloco a ser gravado. Isso é definido pelo provedor do driver PF.

[in] Buffer

Um ponteiro para um buffer que contém os dados a serem gravados no espaço de configuração do VF.

Length

O comprimento em bytes desta operação de gravação. Não deve ser maior que VPCI_MAX_READ_WRITE_BLOCK_SIZE definido em Pcivirt.h.

Valor de retorno

Retorne STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro NTSTATUS apropriado.

Observações

Essa função de retorno de chamada é implementada pelo driver de função física (PF). Ele é invocado quando o sistema deseja ler um bloco de configuração para um de seus VFs.

O driver PF registra sua implementação definindo o membro WriteVfConfigBlock do SRIOV_DEVICE_INTERFACE_STANDARD, configurando uma estrutura de WDF_QUERY_INTERFACE_CONFIG e chamando WdfDeviceAddQueryInterface.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
cabeçalho	pcivirt.h
IRQL	PASSIVE_LEVEL

Compartilhar via