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 |
IRQL | PASSIVE_LEVEL |