NtDoc

No description available.

Windows Driver Kit DDI reference (nf-acxstreams-acxstreaminitassignacxrequestpreprocesscallback)

Description

The AcxStreamInitAssignAcxRequestPreprocessCallback function assigns an AcxRequestPreprocessCallback to a stream.

Parameters

`StreamInit`

Defined by a ACXSTREAM_INIT object, that is used to define the stream initialization. For more information about ACX Objects, see ACX - Summary of ACX Objects.

`EvtObjectAcxRequestPreprocess`

An EvtObjectAcxRequestPreprocess that will be called by the ACX framework before any internal handling of the request is performed.

`DriverContext`

An optional ACXCONTEXT object that represents the current driver context.

`RequestType`

The ACX_REQUEST_TYPE enum that is that is used to define the request type. If AcxRequestTypeAny is specified, EvtObjectAcxRequestProcess will be called for all requests.

`Set`

A pointer to a GUID that represents a KSPROPERTY SET, for example KSPROPSETID_RtAudio. If NULL or GUID_NULL are specified, EvtObjectAcxRequestPreprocess will be called for each request that matches RequestType

`Id`

A value that represents a KSPROPERTY Id. For example a A KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT that uses a KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY structure. If AcxItemIdAny is specified, EvtObjectAcxRequestPreprocess will be called for each property for the specified Set.

Return value

Returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code. For more information, see Using NTSTATUS Values.

Remarks

AcxStreamInitAssignAcxRequestPreprocessCallback gives the driver the opportunity to handle any requests before ACX performs framework handling. The driver can call AcxStreamDispatchAcxRequest to allow ACX to handle the request. If the driver handles the request itself, it can call WdfRequestComplete or WdfRequestCompleteWithInformation to complete the request.

The driver must call either AcxStreamDispatchAcxRequest or WdfRequestComplete (or WdfRequestCompleteWithInformation). The driver must not call more than one of these APIs with the request.

The driver can register more than one AcxRequestPreprocessCallback. The ACX framework will call the first assigned AcxRequestPreprocessCallback that matches a request.

Example

Example usage is shown below.

    //
    // Intercept register and unregister events properties.
    //
    status = AcxStreamInitAssignAcxRequestPreprocessCallback(
                                            StreamInit,
                                            EvtStreamRequestPreprocessRegisterNotificationEvent,
                                            (ACXCONTEXT)Circuit,
                                            AcxRequestTypeProperty,
                                            &KSPROPSETID_RtAudio,
                                            KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT);

    //
    // Intercept all other RtAudio properties - this must be after the above Assign call
    // since the above Assign call is more specific.
    //
    status = AcxStreamInitAssignAcxRequestPreprocessCallback(
                                            StreamInit,
                                            EvtStreamRequestPreprocessRtAudio,
                                            (ACXCONTEXT)Circuit,
                                            AcxRequestTypeProperty,
                                            &KSPROPSETID_RtAudio,
                                            AcxItemIdAny);

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

AcxStreamInitAssignAcxRequestPreprocessCallback - NtDoc