Função SpbDeviceInitConfig (spbcx.h)
O método SpbDeviceInitConfig anexa a extensão de estrutura do SPB (SpbCx) à cadeia de solicitações de E/S para um objeto WDFDEVICE (FDO ou PDO) que deve ser criado.
Sintaxe
NTSTATUS SpbDeviceInitConfig(
[in, out] WDFDEVICE_INIT *DeviceInit
);
Parâmetros
[in, out] DeviceInit
Um ponteiro para a estrutura WDFDEVICE_INIT que deve ser configurada.
Retornar valor
SpbDeviceInitConfig retornará STATUS_SUCCESS se a chamada for bem-sucedida. Os possíveis valores retornados incluem o código de erro a seguir.
| Código de retorno | Descrição |
|---|---|
|
Não é possível alocar os recursos necessários do sistema. |
Comentários
Esse método associa as informações de configuração do SpbCx à estrutura WDFDEVICE_INIT para o objeto de dispositivo (PDO ou FDO) que deve ser criado. A rotina de retorno de chamada EvtDriverDeviceAdd do driver deve chamar SpbDeviceInitConfig antes de chamar o método WdfDeviceCreate para criar o objeto do dispositivo.
Exemplos
O exemplo de código a seguir mostra como usar o método SpbDeviceInitConfig para associar as informações de configuração da extensão da estrutura SpbCx à estrutura WDFDEVICE_INIT .
//
// FxDeviceInit is a pointer to a WDFDEVICE_INIT structure that comes as a
// parameter for an EvtDriverDeviceAdd handler, or from WdfPdoInitAllocate.
//
status = SpbDeviceInitConfig(FxDeviceInit);
if (!NT_SUCCESS(status))
{
return status;
}
//
// Set WDF and SpbCx device-level configuration options.
//
...
//
// Call WdfDeviceCreate
//
status = WdfDeviceCreate(&FxDeviceInit,...);
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8. |
| Plataforma de Destino | Universal |
| Cabeçalho | spbcx.h |
| Biblioteca | Spbcxstubs.lib |
| IRQL | PASSIVE_LEVEL |