Função SpbDeviceInitConfig (spbcx.h)
O método SpbDeviceInitConfig anexa a extensão da estrutura 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 de WDFDEVICE_INIT que deve ser configurada.
Valor de retorno
SpbDeviceInitConfig retornará STATUS_SUCCESS se a chamada for bem-sucedida. Os valores de retorno possíveis 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. |
Observações
Esse método associa as informações de configuração do SpbCx à estrutura WDFDEVICE_INIT para o objeto de dispositivo (PDO ou FDO) a ser criado. A rotina de retorno de chamada do do driver EvtDriverDeviceAdd 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 de 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 |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8. |
| da Plataforma de Destino | Universal |
| cabeçalho | spbcx.h |
| biblioteca | Spbcxstubs.lib |
| IRQL | PASSIVE_LEVEL |