acxStreamDispatchAcxRequest 函式 (acxstreams.h)

AcxStreamDispatchAcxRequest 會使用 WDFREQUEST 架構要求對象來分派 ACX 要求。 AcxStreamDispatchAcxRequest 是在透過 AcxStreamInitAssignAcxRequestPreprocessCallback 註冊的EVT_ACX_OBJECT_PREPROCESS_REQUEST事件處理程式內容中呼叫，以指出應該由 ACX 架構處理要求。

語法

NTSTATUS AcxStreamDispatchAcxRequest(
  ACXSTREAM  Stream,
  WDFREQUEST Request
);

參數

Stream

現有的 ACXSTREAM 物件。 ACXSTREAM 物件代表線路所建立的音訊數據流。 如需詳細資訊，請參閱 ACX - ACX 物件的摘要。

Request

傳遞至 EVT_ACX_OBJECT_PREPROCESS_REQUEST 事件處理程式的 WDFREQUEST 物件句柄。 如需 WDF 要求的一般資訊，請參閱 建立架構要求物件。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

對於 AcxStream 物件的驅動程式EVT_ACX_OBJECT_PREPROCESS_REQUEST呼叫，驅動程式應該呼叫 WdfRequestComplete 或 AcxStreamDispatchAcxRequest，但不應該同時呼叫這兩者。

範例

範例使用方式如下所示。

VOID
Codec_EvtStreamRequestPreprocess(
    _In_    ACXOBJECT  Object,
    _In_    ACXCONTEXT DriverContext,
    _In_    WDFREQUEST Request
    )
/*++

Routine Description:

    This function is an example of a preprocess routine.

--*/
{
    //
    // Just give the request back to ACX. Normally the driver would take steps to examine
    // the Request and take action if necessary.
    //
    AcxStreamDispatchAcxRequest((ACXSTREAM)Object, Request);
}

ACX 需求

最小 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

另請參閱

• acxstreams.h 標頭