Функция SpbDeviceInitConfig (spbcx.h)

Статья
02/26/2024

Метод SpbDeviceInitConfig присоединяет расширение платформы SPB (SpbCx) к цепочке запросов ввода-вывода для создаваемого объекта WDFDEVICE (FDO или PDO).

Синтаксис

NTSTATUS SpbDeviceInitConfig(
  [in, out] WDFDEVICE_INIT *DeviceInit
);

Параметры

[in, out] DeviceInit

Указатель на WDFDEVICE_INIT структуру, которую необходимо настроить.

Возвращаемое значение

SpbDeviceInitConfig возвращает STATUS_SUCCESS, если вызов выполнен успешно. Возможные возвращаемые значения включают следующий код ошибки.

Код возврата	Описание
STATUS_INSUFFICIENT_RESOURCES	Не удается выделить необходимые системные ресурсы.

Этот метод связывает сведения о конфигурации spbCx со структурой WDFDEVICE_INIT для создаваемого объекта устройства (PDO или FDO). Подпрограмма обратного вызова EvtDriverDeviceAdd драйвера должна вызвать SpbDeviceInitConfig , прежде чем вызывать метод WdfDeviceCreate для создания объекта устройства.

Примеры

В следующем примере кода показано, как использовать метод SpbDeviceInitConfig для связывания сведений о конфигурации расширения платформы SpbCx со структурой 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,...);

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	spbcx.h
Библиотека	Spbcxstubs.lib
IRQL	PASSIVE_LEVEL