PFNKSDEVICECREATE callback function (ks.h)
An AVStream minidriver's AVStrMiniDeviceAdd routine notifies the minidriver that AVStream's PnP AddDevice routine has completed.
Syntax
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
Parameters
[in] Device
Pointer to a KSDEVICE structure describing the functional device object (FDO) that has just been created.
Return value
Should return STATUS_SUCCESS or the error code that was returned from the attempt to perform the operation. If the minidriver returns failure status, the related AddDevice call will also fail. See the Remarks section below for more details.
Remarks
The minidriver specifies this routine's address in the Add member of its KSDEVICE_DISPATCH structure.
AVStream calls AVStrMiniDeviceAdd from its default AddDevice routine, at KSDEVICE initialization time. At the point at which this routine is called, the WDM device object (DEVICE_OBJECT) has been created, the KSDEVICE structure has been instantiated and initialized, and the KS device header has been allocated.
Minidrivers can use this routine to associate context information with the AVStream device object, or to initialize a device extension.
If this routine returns an unsuccessful status code, AVStream's AddDevice routine will fail. STATUS_PENDING is not a legal return code because no IRP is involved. The routine is called at IRQL = PASSIVE_LEVEL only.
This routine is optional.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions. |
| Target Platform | Desktop |
| Header | ks.h (include Ks.h) |
| IRQL | PASSIVE_LEVEL (See Remarks section) |