Função WdfDeviceInitSetIoType (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

O método WdfDeviceInitSetIoType define o método ou a preferência de como um driver acessará os buffers de dados incluídos em solicitações de leitura e gravação para um dispositivo especificado.

Sintaxe

void WdfDeviceInitSetIoType(
  [in] PWDFDEVICE_INIT    DeviceInit,
  [in] WDF_DEVICE_IO_TYPE IoType
);

Parâmetros

[in] DeviceInit

Um ponteiro para uma estrutura WDFDEVICE_INIT .

[in] IoType

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

Retornar valor

Nenhum

Comentários

KMDF Se você estiver escrevendo um novo driver usando o KMDF versão 1.13 ou posterior, deverá usar WdfDeviceInitSetIoTypeEx. Chamar WdfDeviceInitSetIoType de um driver de filtro KMDF não tem efeito. Para drivers de filtro, a estrutura usa o tipo de E/S especificado pelo driver mais baixo na pilha do driver.

UMDF Se você estiver convertendo um driver KMDF que chama WdfDeviceInitSetIoType para UMDF versão 2.0 ou posterior, seu driver convertido poderá continuar a chamar WdfDeviceInitSetIoType sem problemas. No entanto, se você estiver escrevendo um driver totalmente novo usando o UMDF versão 2.0 ou posterior, deverá usar WdfDeviceInitSetIoTypeEx.

Se um driver chamar WdfDeviceInitSetIoType, ele deverá fazer isso antes de chamar WdfDeviceCreate. Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo framework.

Se o driver não chamar WdfDeviceInitSetIoType, a estrutura definirá o método de acesso a buffer do driver como WdfDeviceIoBuffered, para o dispositivo especificado.

Para obter mais informações sobre métodos de acesso a buffers, consulte Acessando buffers de dados.

Exemplos

O exemplo de código a seguir indica que um driver usará o método de E/S direto quando acessar o dispositivo.

WdfDeviceInitSetIoType(
                       DeviceInit,
                       WdfDeviceIoDirect
                       );

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
Cabeçalho	wdfdevice.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Regras de conformidade de DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Confira também

IWDFDeviceInitialize2::SetIoTypePreference

WDF_DEVICE_IO_TYPE

WdfDeviceInitSetIoTypeEx