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 tipo WDF_DEVICE_IO_TYPEque identifica o método que o driver usará para acessar buffers de dados recebidos para solicitações de leitura e gravação.
Valor de retorno
Nenhum
Observações
KMDF Se você estiver escrevendo um novo driver usando 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 de 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á fazê-lo 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 para 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 |
|---|---|
| da 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) |