estrutura WDF_IO_TYPE_CONFIG (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

A estrutura WDF_IO_TYPE_CONFIG especifica o método de acesso de buffer preferencial do driver para solicitações de leitura e gravação e para solicitações de controle de E/S do dispositivo.

Sintaxe

typedef struct _WDF_IO_TYPE_CONFIG {
  ULONG              Size;
  WDF_DEVICE_IO_TYPE ReadWriteIoType;
  WDF_DEVICE_IO_TYPE DeviceControlIoType;
  ULONG              DirectTransferThreshold;
} WDF_IO_TYPE_CONFIG, *PWDF_IO_TYPE_CONFIG;

Membros

Size

Tamanho dessa estrutura em bytes.

ReadWriteIoType

KMDF Um enumerador de tipo WDF_DEVICE_IO_TYPE que identifica o método que o driver usará para acessar buffers de dados recebidos para solicitações de leitura e gravação.

UMDF Um enumerador de tipo WDF_DEVICE_IO_TYPE que identifica o método que você prefere que o driver use para acessar buffers de dados de solicitações de leitura e gravação. Os valores válidos incluem WdfDeviceIoBuffered e WdfDeviceIoDirect.

DeviceControlIoType

Esse membro não se aplica ao KMDF.

UMDF Um enumerador de tipo WDF_DEVICE_IO_TYPE que identifica o método que você prefere que o driver use para os buffers de dados de solicitações IOCTL. Os valores válidos incluem WdfDeviceIoBuffered e WdfDeviceIoDirect.

DirectTransferThreshold

Esse membro não se aplica ao KMDF.

UMDF Um valor opcional que especifica o menor tamanho de buffer, em bytes, para o qual a estrutura usará E/S direta para um dispositivo. Por exemplo, defina DirectTransferThreshold como 12288 para indicar que a estrutura deve usar E/S em buffer para todos os buffers menores que 12 quilobytes e E/S direta para buffers iguais ou maiores que 12 quilobytes. Normalmente, você não precisa fornecer esse valor porque a estrutura usa configurações que fornecem o melhor desempenho.

Comentários

A estrutura WDF_IO_TYPE_CONFIG é usada como entrada para o método WdfDeviceInitSetIoTypeEx .

Para inicializar uma estrutura de WDF_IO_TYPE_CONFIG , o driver deve chamar WDF_IO_TYPE_CONFIG_INIT.

Se você estiver escrevendo um driver usando UMDF versão 2.0 ou posterior, consulte Gerenciando métodos de acesso a buffer em drivers UMDF para obter mais informações sobre como especificar métodos de acesso de buffer preferenciais.

Se você estiver escrevendo um driver usando UMDF versão 1. x, seu driver chama IWDFDeviceInitialize2::SetIoTypePreference para especificar métodos de acesso de buffer preferenciais.

Requisitos

Confira também

WDF_DEVICE_IO_TYPE

WDF_IO_TYPE_CONFIG_INIT

WdfDeviceInitSetIoTypeEx