SpbDeviceInitConfig 함수(spbcx.h)
SpbDeviceInitConfig 메서드는 만들 WDFDEVICE(FDO 또는 PDO) 개체의 I/O 요청 체인에 SPB 프레임워크 확장(SpbCx)을 연결합니다.
통사론
NTSTATUS SpbDeviceInitConfig(
[in, out] WDFDEVICE_INIT *DeviceInit
);
매개 변수
[in, out] DeviceInit
구성할 WDFDEVICE_INIT 구조체에 대한 포인터입니다.
반환 값
SpbDeviceInitConfig 호출에 성공하면 STATUS_SUCCESS 반환합니다. 가능한 반환 값에는 다음 오류 코드가 포함됩니다.
| 반환 코드 | 묘사 |
|---|---|
|
필요한 시스템 리소스를 할당할 수 없습니다. |
발언
이 메서드는 SpbCx에 대한 구성 정보를 만들 디바이스 개체(PDO 또는 FDO)의 WDFDEVICE_INIT 구조와 연결합니다. 드라이버의 EvtDriverDeviceAdd 콜백 루틴은 WdfDeviceCreate 메서드를 호출하여 디바이스 개체를 만들기 전에 SpbDeviceInitConfig 호출해야 합니다.
예제
다음 코드 예제에서는 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 |